Documentation
ExyliaSpecials
Special items built from YAML: abilities written in a 37-step action language, fifteen tool behaviours, limits by uses or time, cooldowns and region rules, with 70 items included and every number editable in game. Plus stat trackers, a built-in combat tag with logout NPCs and a safe-zone barrier (or DeluxeCombat, CelestCombat, PvPManager), cooldowns for vanilla items, and 1v1 duel arenas played on copies.
- Version
- v4.2.0
- Minecraft
- 1.21+
- Category
- Gamemode
- Pages
- 18
Getting started03
IntroductionWhat ExyliaSpecials is, what it covers, what it needs to run and how this documentation is organised.InstallationThe loader jar and the licence, dependencies and what each optional plugin adds, the files the plugin writes, what goes to the database, languages and updating.First stepsGive yourself a bundled item, change its numbers in game, hand items to players, and write a first item of your own.
Special items06
Special itemsThe item file key by key: settings and texts, the item itself, permission, limits by uses or time, cooldowns, region rules, features and triggers, the order every use is checked in, and what the plugin protects special items from.Action languageEvery step an ability can run: targeting, damage, movement, effects and states, items, blocks, projectiles, feedback, flow control, summons and duels, with every key and its default.StatesThe twelve states an ability can put on a player — invulnerable, frozen, silenced, lifesteal, flight, vanished, last stand and the rest — what each one does, how long it lasts and how it is shown.Bundled itemsThe 70 items that ship with ExyliaSpecials: what each one does, its material, limit and cooldown, and the settings it exposes to the in-game form.ToolsThe fifteen tool features — area break, vein miner, tree capitator, replant, till, seed planter, bone meal, crowbar, infinite buckets, magnet, prospector, compressor, void filter, telekinesis and auto smelt — with every key, how they break blocks, and the in-game editors.Stat trackersTrackers that count kills, blocks, arrows, damage or fish on any item: the eight bundled ones, how players apply them, exactly what each stat counts, the tracker file, and removing or resetting them.
Systems03
CombatWhere the combat tag lives now: ExyliaCombat owns tagging, restrictions, logout NPCs, the safe-zone barrier and vanilla cooldowns; ExyliaSpecials only reads the tag, and moves old settings over.CooldownsCooldowns of special items: where they are set, the action bar, and the commands that change them. Vanilla item cooldowns live in ExyliaCombat.Duels1v1 duels started by an item: building an arena, snapshots and copies, the rules inside an arena, how a duel runs from countdown to loot, what happens on quit, death or restart, and the duel settings.
Reference06
CommandsEvery /specialsadmin subcommand: items, trackers, cooldowns and arenas, who can run it and whether it works from the console.PermissionsEvery node the plugin checks, what it lets through, the wildcards, and what is not gated at all.PlaceholdersEvery %exyliaspecials_...% placeholder: combat, the held item, cooldowns, stat trackers and states.Configurationconfig.yml key by key, the messages file and its sections, the admin menu files, and where items, trackers and arenas are configured.APISpecialsService from exylia-api: items, cooldowns, combat, states and duels from another plugin, and the events fired on item use and duels.Frequently asked questionsThe questions that come up most.