Endless Leveling

Install, staff-command, permission and configuration reference for the core plugin, EndlessLevelingCore. Every other Endless addon runs on top of it. For how levels, prestige and augments play, see the Endless Leveling gameplay guide.

• Plugin version: 14.1.2
• Jar: EndlessLeveling.jar (the file name carries no version)
• Data folder: mods/Airijko_EndlessLevelingCore/

Requirements

EL-Core has no hard plugin dependencies. Some features need a Server Addon (a partner addon jar) as well. Any tier unlocks XP boosts, console use of most admin commands and raid slots in the Activity Director. The external MySQL store needs the SSS or Z tier, the campaign needs the Z tier, and cross-server raids need the Official (SSS) addon with an active license. Those rows are marked below.

Who counts as an admin

Most staff commands check for admin access when they run. A player has admin access when either of these is true:

• they are an engine operator, or in a permission group named op, admin or administrator;
• they hold any of these nodes:

*  op  operator  admin
hytale.*  hytale.op  hytale.operator  hytale.admin
endlessleveling.*  endlessleveling.op  endlessleveling.operator  endlessleveling.admin

• or they hold any node that ends in .*, or that has op, operator, admin, administrator or owner as one of its parts (for example essentials.* or staff.admin).

Grant broad wildcards carefully: they make that player an Endless Leveling admin.

Commands marked (engine node) below also carry the engine's generated command permission, airijko.endlesslevelingcore.command.<path>. For example, /lvl reload carries airijko.endlesslevelingcore.command.lvl.reload. A staff member who holds endlessleveling.admin but not * also needs that node, or the engine blocks the command before EL-Core's own check runs. Granting airijko.endlesslevelingcore.command.* covers all of them.

Command roots

The main root is /lvl. Its aliases are /el, /sk, /eskills, /level and /endlessleveling. If another mod already owns /lvl, EL-Core takes the first free alias and logs a warning.

These shortcut roots are registered as well: /profile (/profiles), /ps, /races (/race), /classes (/class), /priest, /augments (/augment, /aug, /a), /dungeons (/dungeon), /raid, /join, /leave, /upcoming (/nextevent, /whatsnext), /xpstats (/xps), /bounty, /eqrreload and /party (only when PartyPro is installed).

/leave is also registered by Endless Rifts. When Rifts is installed, its /leave wins.

Player commands (/lvl prestige, /profile, /races, /classes, /augments reroll, /join, /leave, /lvl claim, and so on) need no permission and are covered in the gameplay guide.

Admin Commands: player data

All are /lvl <command>. [player] means you can leave the player out to target yourself.

Augment admin (/augments …)

All carry the engine node.

Admin Commands: server and content

Raids (/raid …, also /lvl raid …)

join, time and netboard are open to players. Everything else is admin.

Shared dungeons and campaign

XP boosts (Server Addon only)

This subtree only exists when a Server Addon is installed.

Debug and developer tools

/lvl debug …, /lvl spawn <boss> [level], /lvl telegraph …, /lvl augmenttest …, /lvl bossbar, /lvl applymodifiers and /lvl trim_instance <radius> <minY> are development tools. /lvl debug is gated only by its engine node, airijko.endlesslevelingcore.command.lvl.debug. trim_instance deletes chunks and blocks in the world you stand in. Keep these to developers.

Console use

These admin commands refuse the console unless a Server Addon is installed: setlevel, setprestige, resetlevel, resetprestige, resetall, resetallplayers, resetskillpoints, skillpointssync, syncraceclass, syncplayerraceclass, addswapsall, /races addswap, /classes addswap, resetcampaign, resetcampaignall, checkprofile, xp give, rank, the /augments admin commands, import, build, temp, storage, backup, restore, restoreprofile and xpstats refresh|feed. In-game admins are unaffected.

reload, overrides, director, inv, sync, copyprofile, resetraidcooldown, resetraidcooldownall, and the /raid and shared-dungeon commands accept the console. /raid call needs a Server Addon there. resetcooldowns, /raid admin, /priest admin remove and dungeon tp are in-game only.

Permissions

There are three kinds of node.

Explicit grant only

These match only the literal node. *, endlessleveling.*, op/admin groups and prefix wildcards do not grant them, so an admin never skips a cooldown by accident. Nobody has them by default.

Staff tool nodes

Admins and wildcards already pass these. Grant the node to give a non-admin staff member just that tool. The root node grants every sub-node.

Normal nodes

An exact grant or admin access passes these.

Configuration & Tuning

All files live in mods/Airijko_EndlessLevelingCore/. Apply changes with /lvl reload.

Edit server-overrides.json, not the bundled files

Most bundled files are rewritten from the jar while their force_builtin_* flag in config.json is true (the default). config.json and leveling.json are re-synced every time they load, so a hand edit is reverted on the next /lvl reload as well as on restart. dungeons.json, world-settings/, races/, classes/, augments/ and passives/ are replaced when an update ships a newer bundled version. The old copy is archived to old/ first.

You have two supported options:

1. server-overrides.json (recommended). It is created once and never overwritten. Its values are laid over the loaded config at runtime, so updates keep working. Only the keys already listed in the file are honoured; an unknown key is logged as a warning and ignored. After an update, run /lvl overrides sync to preview. /lvl overrides sync apply adds new keys, drops keys that no longer exist, refreshes the help text and saves a backup first. Your values are kept.
2. Turn a flag off. Set force_builtin_config, force_builtin_leveling, force_builtin_dungeons and so on to false in config.json. Those flags survive rewrites. The file then keeps your values and only gains new keys on update. You also stop getting balance fixes for that file.

Level-cap and prestige keys in leveling.json, and everything in dungeons.json except reward_commands_enabled, are not in the overrides list. Changing them means option 2.

Never overwritten, so edit them directly: server-overrides.json, world-settings/disabled-worlds.json, everything under raids/, and activity/activity-director.json.

Main files

Money rewards. Dungeon reward commands (xp_banking.reward_commands, for example eco give) can be switched off server-wide with reward_commands_enabled in server-overrides.json. Raid reward commands, set in each raid's rewards.json, have no such switch.

Imports on a busy server. Installing, updating or removing a pack applies live, but briefly freezes every world while assets re-register. Large installs and forced updates or removals are refused above imports.live_apply_max_online (10) players online; packs of 8 MiB or less still install. Removing a pack with players online hides it now and unloads it at the next restart. imports.live_apply_override skips the check. With auto_update_imports on, pack updates apply at boot.

Player data

Player data is SQLite at db/endlessleveling.db. Backups go to backups/suite/ and deleted profiles to backups/deleted-profiles/ (20 per player, kept 90 days). An external MySQL store needs the SSS or Z Server Addon.

If the data folder is read-only, EL-Core moves its data to a user-writable location and logs where.

JVM flags

Integrations

• LuckPerms: no API hook. prestige_rank_sync in events.json and /lvl rank resync run lp user … promote / parent set console commands.
• PlaceholderAPI: registers %el_*% and %endlessleveling_*%. Token list on the Placeholder API page.
• PartyPro: parties, /party, party XP share.
• EndlessLink: titles, Discord server-log relay, inbox, raid pre-reminders.
• Endless Skills, Fates, Elite Mobs, Tower: detected at runtime, never required. Tower can unlock classes and, through tower_integration in config.json, take over reroll and swap rewards.
• Economy: EL-Core uses no economy API. Money comes from reward console commands (see above).
• OrbisGuard, SimpleClaims: Priest church placement respects their claims.