The visual config editor includes the actual config.yml, talents.yml and equipment.yml defaults. Import your existing files first to preserve your settings. Player data and parties.yml do not belong in the editor.
Engine settings
| Section | Settings |
|---|---|
pack |
Sending, built-in hosting, port, public address, custom URL, forced acceptance, assume-loaded mode |
controls |
Enable companion casting/tree, enable vanilla casting, minimum ticks between companion or command cast attempts |
progression |
Maximum level, starting points, points per level, quadratic XP curve, kill XP cap/multiplier, refunds |
party |
Enable parties, standalone size/invite lifetime, friendly fire, party-only healing |
party.hud |
Enable frames, maximum rows (1–8), horizontal offset from centre, vanilla fallback refresh interval, fallback toggle |
integrations.dungeonforge |
Enable the shared party provider; require ready status for party entry |
| Root | pvp, global damage-scale, debug logging |
party.hud.x defaults to -138 GUI pixels from screen centre. The frame is 152 pixels wide. Adjust it for your GUI scale and other HUD plugins. Packed frames update with the main HUD; refresh-ticks applies to companion snapshots and the vanilla boss-bar fallback. Four rows are designed for typical GUI scales; eight rows need more vertical space.
Edit the talent tree
talents.yml contains foundations and branches lists. Branch templates expand once per skill using {skill}, {name} and {icon}. Stable node IDs preserve builds across changes.
| Node field | Meaning |
|---|---|
id |
Unique stable node ID; lowercase letters, digits, dot, underscore or hyphen |
name, description, icon |
Text and resource-pack item model |
slot |
Inventory position 9–44; unique within its page; also determines canvas position |
max-rank, cost |
Rank limit (1–64), points per rank (at least one) |
level, spent |
Minimum character level and total invested points |
requires |
Map of prerequisite node IDs to required ranks |
exclusive |
Shared choice group; only one node in that group may be learned |
scope |
A skill ID (usually {skill}), or omitted for a global effect |
effects |
Per-rank numeric modifiers |
Supported effects: power, cooldown, cost, health, resource, resistance, crit. Values are fractions (0.08 means 8%), except health, which uses health points. Cooldown, cost and resistance values reduce their respective quantities. Resource improves both capacity and regeneration. Use global scope for health, resource and resistance; those attributes are not cast-specific. aug.{skill} resolves the class's existing named augment and behavior.
You can add or remove nodes within the eight pages, change ranks, prerequisites, choice groups, effects, labels and positions. New active skill behavior and additional class-specific augment implementations still require class-plugin code. The stock pack's painted connector layout is fixed; custom slot layouts need matching pack art. The companion draws prerequisite lines from the configured graph automatically.
Apply and recover
Back up configuration files, edit, then run /hud reload or /class reload with forgehud.admin. Existing heroes' attributes are recalculated. Open /talents again to refresh its display. Cycles, overlapping slots, missing prerequisites and invalid node limits reject the talent reload and retain the previous working talent rules; inspect the console for the reason.
Restart for pack hosting changes and plugin installation/removal. Reducing level budgets or increasing node prices does not silently wipe saved builds. Existing investment may exceed the new budget until refunded. Nodes removed from configuration stop contributing effects, but their recorded points remain refundable. Back up before large balance changes.
All four class plugins also retain their own config.yml files for skill costs, cooldowns, damage, resource behavior and class-specific tuning. Their startup values require the class plugin's documented reload or a server restart.
Permissions: forgehud.use defaults to everyone; forgehud.admin defaults to operators. DungeonForge permissions are separate.
Equipment and local party layout
See Class equipment collections for all equipment.yml fields and item persistence rules. Companion HUD position, scale and compact mode are personal settings in config/forgehud-controls.json, editable through F8 → Party layout. party.hud.x affects only the resource-pack fallback.