Install, integration and admin grant-command reference for server operators. For how the weapon platform plays — tiers, Essence, upgrades, Lootbags — see the Endless Forged gameplay guide.
- Plugin version: 0.11.0
Requirements
| Plugin | Version | Type |
|---|---|---|
| EndlessLevelingCore | any | Optional — the weapon platform (tiers, Essence, upgrades, /weapons) only activates with EL Core present; the vanilla-gear asset pack runs standalone without it |
| VaultUnlocked | ≥ 2.20.0 | Optional (economy bridge — only matters if you set a non-zero money cost on upgrade checkpoints) |
| Endgame & QoL | any | Optional (config-only integration) |
Admin Commands (staff)
All gated behind endlessforged.admin.<verb> permission nodes. Subcommands of /weapons (aliases /weapon, /forged).
| Command | Effect |
|---|---|
/forged give [tokens] | Mint and hand over a weapon — every property optional, see token vocabulary below |
/forged level <n|max|+n|-n> | Set the held weapon's level, clamped to its tier cap |
/forged tier <E..S|default|up|down> | Retier the held weapon in place |
/forged reroll [main|sub|all|values] | Re-roll stats or just the roll factors |
/forged set <tokens> | Precisely set main/sub/rolls/level/tier on the held weapon |
/forged bind [player|none] | Set or clear the soulbind owner |
/forged strip | Remove all Forged metadata from the held item |
/forged info | Full instance dump — ids, rolls, effective stats, damage, EL bonus channels |
/forged list [filters] | Text listing of the registry, to find weapon ids |
/forged essence [tier] <amount> [to=] | Grant Essence of a tier (default E) |
/forged forgecore [tier] <amount> [to=] | Grant Forged Cores of a tier (default E) |
/forged lootbag [tier] <amount> [to=] | Grant Forged Lootbags of a tier (default E) |
/forged admin | Open the visual grant-builder UI |
/forged reload (/weapons reload) | Re-read forged-balance.json and rebuild the registry — no restart needed |
Token Vocabulary (/forged give and /forged set)
Shared by the command parser and any future JSON-driven grant (quest reward, lootbox table) — the same tokens work in both places.
| Token | Values | Default when omitted |
|---|---|---|
weapon= | Forged id, item id, or a name substring | Random from the filtered pool |
tier= | E..S, random, default | The weapon's own definition tier |
main= | strength, sorcery, defense, random | The weapon's roll mode decides |
sub= | any stat, random | The weapon's roll mode decides |
level= | 1..cap, max, random | 1 |
rolls= | min, mid, max, random | random |
mainroll= / subroll= | 0.0..1.0, min, mid, max, random | Follows rolls |
count= | 1..64 | 1 |
to= | player name | The sender |
bind= | true, false | true |
type= | a weapon type — narrows a random pick | any |
creator= / mod= | narrows a random pick | any |
Bare positional tokens work too (/forged give spirit_calibur S max), but must come before any --flag — once the parser sees a --flag, every following token is parsed as that flag's value.
⚠️ Roll tokens are inert while statVariance.enabled is off in forged-balance.json (the shipped default) — stat values are fixed per tier with no band to roll into. /forged info prints (fixed by tier) in this state. Turn on statVariance.enabled and /weapons reload to make rolls=/mainroll=/subroll= actually do something.
Wiring Up Essence, Cores & Lootbag Drops
Endless Elite Mobs is the only live drop source today, through its existing per-rarity loot table — no code change, no second listener. Merge the block documented in the Endless-Forged repo's docs/ENDLESS_ESSENCE_EEM_SETUP.md into elite-mobs-config.json's loot.drops_per_rarity, then run /eem reload. Item ids: Endless_Essence[_<tier>], Forged_Core_<tier>, Forged_Lootbag_<tier> (E has no suffix on Essence).
Cores and Lootbags are meant to drop far less often than Essence — the shipped example config weights them roughly Essence-most-common, Cores less common, Lootbags rarest still. Whole-weapon and Lootbag acquisition beyond elite-mob drops (quest rewards, shop rows, raid/dungeon rewards) is specified in the mod's own docs but not yet wired into every other Endless mod — check FORGED_ECONOMY_INTEGRATION.md in the repo for current cross-mod status before promising a specific source to players.
Balance Configuration
forged-balance.json (in the mod's data folder) holds tier stat multipliers, level caps, the Essence economy, upgrade checkpoint costs and per-weapon overrides. It's runtime-reloadable (/weapons reload, no restart) and version-gated — the bundled schema is version 11; an older on-disk config auto-migrates forward on load rather than needing a manual rewrite.
Notable defaults worth knowing before you tune:
| Setting | Shipped default |
|---|---|
| Essence needed per tier (E → S) | 50 / 100 / 200 / 400 / 800 / 1,600 |
Max Essence spent per /weapons levelup call | 256 |
| Upgrade Core cost per checkpoint | 4 / 10 / 18 / 28 / 40 (running total 4 / 14 / 32 / 60 / 100) |
| Upgrade money cost | $0 (Cores-only unless you set upgrades[].money) |
statVariance.enabled | off (stats are fixed per tier, not rolled) |
Known Issues
- Aegos (
bow_aegos) needs a Java 26 runtime. Its Forged catalog entry, model and tooltip register fine on Java 25, but the Aegos mod's own plugin — its unique abilities — fails to load (UnsupportedClassVersionError) until the server JVM is upgraded to Java 26. The weapon still equips and shows up normally either way; only its special ability logic is affected. Weapon_Longsword_Noctide's S-tier eligibility is still an open decision upstream. It currently ships at A tier pending a damage comparison against Aegos.
Integrations
| Plugin | Type | Use |
|---|---|---|
| Endless Elite Mobs | Optional | The only live source of Essence/Core/Lootbag drops today |
| Endless Events | Optional | Top-3 placement rewards can pay out Forged Cores |
| VaultUnlocked | Optional | Money leg of upgrade costs, if you set one above $0 |
| Endless Leveling Core | Optional (functionally required) | Main/Substat bonuses feed EL Core's attribute pipeline; without it, only the vanilla-gear asset pack runs |