World Init Skill

World Init Skill

Grants each player a JSON-configurable set of Epic Fight skilltree passives/skills and Curios slot increases the first time they ever join your world — no commands, no KubeJS scripting required.

Features

• Fully data-driven. Edit config/world_init_skill/grants.json to define exactly what gets granted — no recompiling, no code.
• Soft-dependency fallback chains. Each skill slot can list multiple candidates in priority order (e.g. “use this addon’s dodge skill if it’s installed, otherwise fall back to base Epic Fight’s own roll skill”). The first candidate whose mod is actually loaded wins.
• Works with any Epic Fight addon. Not tied to a specific addon list — reference any mod by its modid in the config and it just works, as long as it registers its skills through the normal Epic Fight / Epic Skills (Skill Tree) systems.
• Curios slot grants. Increase any Curios slot type (back, belt, etc.) by any amount.
• Arbitrary commands. A commands list lets you run any server command on first join for anything not covered by the structured grant types, with ${player} substituted for the player’s name.
• Safe by design. Every grant is tracked per-player, per-entry — a player who relogs mid-grant never has anything re-applied or duplicated. A short capped retry window rides out any mod-loading/capability-attach timing races on a freshly created world.
• Live reload. /world_init_skill reload re-reads the config without a restart. /world_init_skill regrant <players> re-queues players for testing.

Example config

json
{
"skills": [
{
"key": "dodge",
"slot": "dodge",
"candidates": [
{ "mod": "efn", "skillTree": "efn:efn_skills", "skill": "efn:efn_dodge" },
{ "mod": "epicfight", "skill": "epicfight:roll" }
]
}
],
"curios": [
{ "key": "back", "mod": "curios", "slot": "back", "amount": 1 }
],
"commands": [],
"messageKey": "world_init_skill.granted"
}

Dependencies

• Epic Fight (required) — this mod has nothing to do without it.
• Epic Skills / Skill Tree addon (optional) — needed only for candidates entries that specify a skillTree to unlock. Skipped gracefully if absent.
• Curios (optional) — needed only for the curios grant list. Skipped gracefully if absent.
  Any other Epic Fight addon you reference by modid in grants.json is a pure soft dependency — nothing to install on our end, no version pinning required.

Why this exists

A first-login skill grant seems simple until you try it on a brand-new world: mods aren’t always fully “warmed up” the instant a player logs in for the very first time. This mod handles that timing robustly with a proper capped retry loop and per-entry tracking, instead of a fragile fixed delay.