Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ProfessorFichte/Bards/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Bards RPG mod uses a structured registration system for items, effects, armor, weapons, and other content. Registration is handled through dedicated classes that create registry entries and apply configurations.

​
Item registration

​
Spell books

Spell books are registered through the BardBooks class, which creates and registers spell book items. Location: com/bards/item/BardBooks.java:11 
public static void register() {
    var books = List.of("bard");
    for (var name: books) {
        SpellBooks.createAndRegister(Identifier.of(MOD_ID, name), Group.KEY);
    }
}
Books registered:
  • bards_rpg:bard - The main bard spell book

​
Armor sets

Armor registration is handled by the Armors class, which defines armor materials, pieces, and configurations. Location: com/bards/item/Armors.java:200 
public static void register(Map<String, ArmorSetConfig> configs) {
    if (FabricLoader.getInstance().isModLoaded("armory_rpgs") || BardsMod.tweaksConfig.value.ignore_items_required_mods) {
        storytellerArmorSet = create(
                storytellers_garb,
                Identifier.of(MOD_ID, "storyteller_garb"),
                40,
                5,
                Armor.CustomItem::new,
                ArmorSetConfig.with(
                        new ArmorSetConfig.Piece(storytellers_garb.value().getProtection(ArmorItem.Type.HELMET))
                                .add(AttributeModifier.multiply(SpellSchools.ARCANE.id, bard_spell_power_t5))
                                .add(AttributeModifier.multiply(SpellSchools.HEALING.id, bard_spell_power_t5))
                                .add(movementSpeed(bard_speed_T5)),
                        // ... other pieces
                ),
                commonSettings(null))
                .translatedName("Storyteller Hat", "Storyteller Tunic", "Storyteller Trousers", "Storyteller Boots");
    }
    Armor.register(configs, entries, Group.KEY);
}
Armor sets registered:
  • Durability multiplier: 10
  • Protection: 1/3/2/1 (head/chest/legs/feet)
  • Enchantability: 9
  • Attributes per piece:
    • +15% Arcane spell power
    • +15% Healing spell power
    • +3% Movement speed
  • Durability multiplier: 20
  • Protection: 1/3/2/1
  • Enchantability: 10
  • Attributes per piece:
    • +20% Arcane spell power
    • +20% Healing spell power
    • +4% Movement speed
  • Durability multiplier: 30
  • Protection: 1/3/2/1
  • Enchantability: 15
  • Attributes per piece:
    • +25% Arcane spell power
    • +25% Healing spell power
    • +5% Movement speed
  • Repair ingredient: Netherite ingot
  • Durability multiplier: 40
  • Protection: 1/3/2/1
  • Enchantability: 18
  • Attributes per piece:
    • +30% Arcane spell power
    • +30% Healing spell power
    • +6% Movement speed
  • Repair ingredient: Netherite ingot
  • Requirement: Requires armory_rpgs mod or development mode

​
Weapons

Weapon registration is handled by the Weapons class, which defines three weapon types: rapiers, lutes, and lyres. Location: com/bards/item/Weapons.java:147 
public static void register(Map<String, WeaponConfig> configs) {
    if (BardsMod.tweaksConfig.value.ignore_items_required_mods || FabricLoader.getInstance().isModLoaded(BETTER_NETHER)) {
        var repair = ingredient("betternether:nether_ruby", FabricLoader.getInstance().isModLoaded(BETTER_NETHER), Items.NETHERITE_INGOT);
        rapier("ruby_rapier", Weapon.CustomMaterial.matching(ToolMaterials.NETHERITE, repair), rapier_t5_attack_damage)
                .translatedName("Ruby Rapier")
                .loot(Equipment.LootProperties.of(4));
        lute("ruby_lute", Weapon.CustomMaterial.matching(ToolMaterials.NETHERITE, repair), lute_t5_attack_damage)
                .translatedName("Ruby Lute")
                .attribute(AttributeModifier.bonus(SpellSchools.ARCANE.id, T4_LUTE_POWER))
                .attribute(AttributeModifier.bonus(SpellSchools.HEALING.id, T4_LUTE_POWER))
                .loot(Equipment.LootProperties.of(4));
    }
    // ... more conditional registrations
    Weapon.register(configs, entries, Group.KEY);
}
Weapon types:
Fast melee weapons with -2.0 attack speed modifier.Base tier weapons:
  • Golden Rapier - 2.1 damage
  • Iron Rapier - 3.6 damage
  • Diamond Rapier - 4.4 damage
  • Netherite Rapier - 5.9 damage
Mod-dependent weapons:
  • Ruby Rapier (Better Nether) - 6.7 damage, tier 4
  • Aeternium Rapier (Better End) - 6.7 damage, tier 4
  • Valkyrie Rapier (Aether) - 6.7 damage
  • Boss rapiers (Loot N Explore) - 6.7 damage, tier 5, rare
  • Singing Blade (Arsenal) - 6.7 damage, tier 5, rare
Damage-focused staves with -3.0 attack speed modifier. Provide both Arcane and Healing spell power.Base tier weapons:
  • Wooden Lute - 4.0 damage, +3.5 Arcane/Healing power
  • Diamond Lute - 6.0 damage, +4.0 Arcane/Healing power
  • Netherite Lute - 8.0 damage, +4.5 Arcane/Healing power
Mod-dependent weapons:
  • Ruby Lute (Better Nether) - 10.0 damage, +5.0 power, tier 4
  • Angelic Lute (Aether) - 10.0 damage, +5.0 power
  • Dragon Lute (Loot N Explore) - 10.0 damage, +5.0 power, tier 5, rare
  • Unique lutes (Arsenal) - 10.0 damage, +5.0 power, tier 5, rare
Healing-focused staves with -2.2 attack speed modifier and 3.0 base damage. Provide 50% less Arcane power but 150% more Healing power compared to lutes.Base tier weapons:
  • Golden Lyre - +1.8 Arcane, +5.3 Healing power
  • Diamond Lyre - +2.0 Arcane, +6.0 Healing power
  • Netherite Lyre - +2.3 Arcane, +6.8 Healing power
Mod-dependent weapons:
  • Aeternium Lyre (Better End) - +2.5 Arcane, +7.5 Healing, tier 4
  • Valkyrie Lyre (Aether) - +2.5 Arcane, +7.5 Healing
  • Siren’s Lyre (Loot N Explore) - +2.5 Arcane, +7.5 Healing, tier 5, rare
  • Lyre of Apollo/Antecael (Arsenal) - +2.5 Arcane, +7.5 Healing, tier 5, rare

​
Effect registration

Status effects are registered through the BardsEffects class, which defines custom beneficial effects for bards. Location: com/bards/effect/BardsEffects.java:82 
public static void register(ConfigFile.Effects config) {
    for (var entry : entries) {
        Synchronized.configure(entry.effect, true);
    }
    Effects.register(entries, config.effects);
}
Effects registered:
ID: bards_rpg:balladIncreases Attack Damage and Spell Power.Attributes per amplifier:
  • +2.5% Generic spell power (multiplicative)
  • +2.5% Attack damage (multiplicative)
Location: BardsEffects.java:28-46
ID: bards_rpg:troubadours_minuetReduces damage taken.Attributes per amplifier:
  • -5% Damage taken (multiplicative)
Location: BardsEffects.java:48-61
ID: bards_rpg:armys_paeonStash effect. The player buffs nearby allies when damaging enemies with melee hits, arrows, or spells.Location: BardsEffects.java:62-70
ID: bards_rpg:armys_motivationWith each melee, arrow, and spell hit, you deal magic damage according to the highest attribute, scaling with the effect amplifier.Location: BardsEffects.java:71-79

​
Item group

The Bards item group is created and registered in BardsMod.registerItems(). Location: BardsMod.java:64-68 
Group.BARDS = FabricItemGroup.builder()
        .icon(() -> new ItemStack(Armors.troubadourArmorSet.armorSet().head.asItem()))
        .displayName(Text.translatable("itemGroup.bards_rpg.general"))
        .build();
Registry.register(Registries.ITEM_GROUP, Group.KEY, Group.BARDS);
Properties:
  • ID: bards_rpg:general
  • Icon: Troubadour Hat
  • Translation key: itemGroup.bards_rpg.general

​
Custom spell impacts

Custom spell impacts are registered through the CustomSpellImpacts class. Location: com/bards/content/CustomSpellImpacts.java:9 
public static void registerCustomImpacts(){
    SpellHandlers.registerCustomImpact(
            Identifier.of(MOD_ID, "armies_paeon_impact"),
            new ArmiesPaeonImpact()
    );
}
Impacts registered:
  • bards_rpg:armies_paeon_impact - Custom impact handler for Army’s Paeon effect

Build docs developers (and LLMs) love

Get started for freeTalk to us