Starts by itself, every year
Teaser, event, Halloween night and a week to spend leftovers, on dates that repeat. To try it today: /hwa event start.
Free
ShadowHalloween
Your Halloween event, ready the moment you install it: candy, hidden pumpkins, haunted houses and a boss.
Minecraft1.26.2 & 1.26.3 PlatformPaper 26.2 & 26.3 Versionnot released
Not available yet
Free In development Gameplay and content
Candy, many ways
Night mobs, doors, hunts, the boss, the calendar and quests. Mob candy is full up to 300 a day: the event never becomes a farm race.
Trick or treat
Three knocks on a door, once a day per house. The staff registers houses, or players open their own and fill them with their candy.
The Headless Horseman
Three phases, attacks announced before they hit, health that grows with the players. Personal loot: nothing drops on the ground.
Zero cost when off
Off season it runs one check a minute, nothing more. During the event every effect has a budget, and when the server slows down the ambience steps aside.
Everything goes back
Every placed block goes into a ledger: /hwa cleanup puts back what was there before, not air, and leaves alone what a player changed.
The roots and their aliases
| Command | Description | Aliases | Permission |
|---|---|---|---|
| /halloweenadmin | ShadowHalloween administration (alias /hwa) | /hwa | shadowhalloween.admin |
| /shadowhalloween | The Halloween event menu: candy, shop, calendar, hunts and the rest (alias /halloween, /hw) | /halloween /hw | shadowhalloween.use |
Player commands 27
| Command | What it does | Permission |
|---|---|---|
| /halloween | The event menu: candy, shop, calendar, hunts, quests, wardrobe, cauldron, boss, leaderboards, achievements, houses visited today, timed courses (when one is ready), scare level (changed with a click), rewards | shadowhalloween.use |
| /halloween help | The list of subcommands | shadowhalloween.use |
| /halloween candy [player] | Balance, season score and today's candy from mobs against the cap (from mobs today: x/300). With a name, another player's, even if offline | shadowhalloween.use |
| /halloween shop | The event shop. Open in RUNNING and AFTERGLOW; during the TEASER you can only look | shadowhalloween.shop |
| /halloween calendar | The October calendar: one box a day, the streak, catching up on missed days | shadowhalloween.calendar |
| /halloween hunt [hunt] | Without an argument the hunts menu; with a hunt id, how many objects you have found out of how many | shadowhalloween.hunt |
| /halloween hunt hint [hunt] | A hint towards the nearest object not found yet: a distance band (very close, close, far) and one of the eight directions, never the coordinates. Two hints are 10 minutes apart (hints.cooldown in hunts.yml). A hint token (in the shop, 3 for 60 candy) skips the wait and the cost: one is spent only when the hint would still be waiting, and the message says how many are left. Tokens last for the season | shadowhalloween.hunt + shadowhalloween.hunt.hint |
| /halloween quests | Today's three quests and the weekly one. With provider: SHADOWQUESTS our board is off and the command says so | shadowhalloween.quests |
| /halloween wardrobe | The wardrobe: the unlocked costumes and the ones still locked, with how to get them. With integrations.shadowcosmetics.wardrobe: SHADOWCOSMETICS in config.yml, and ShadowCosmetics installed with its licence, it opens ShadowCosmetics' wardrobe instead | shadowhalloween.costumes |
| /halloween costume <id|off> | Wears an unlocked costume, or takes it off with off | shadowhalloween.costumes |
| /halloween cauldron | The witch's cauldron menu: donations and brews. To donate and brew you must be within 8 blocks of the cauldron, unless goal.donate-anywhere: true | shadowhalloween.cauldron |
| /halloween boss [join] | The boss in progress with its health, or the next scheduled one, with the [Join] button. With join you go to the arena (with the ShadowEssentials warp if the boss has one, otherwise with a teleport) | shadowhalloween.boss |
| /halloween top [score|hunt|boss|cauldron|hospitality|course:<id>] | The leaderboards: score (the default), objects found, boss damage, candy donated, hospitality points of players' houses, and one for each ready course (course:<id>, best time: the fastest on top). The top places and yours | shadowhalloween.top |
| /halloween achievements | The season's achievements, unlocked and still to unlock | shadowhalloween.achievements |
| /halloween treat <house> | Trick-or-treat at a house, by id or by label. It exists for other plugins' NPCs that run a command on the player's behalf: it works only within 6 blocks of the house (npc.treat-range) and only while the event runs; you cannot knock on your own house this way either. Citizens and ShadowEssentials NPCs also have the direct link, /hwa house link | shadowhalloween.use |
| /halloween house [info] | Your houses: number, position, stock, candy per visit, trick, and your hospitality points. A house that lost its door is closed here, and the stock goes back to your balance. Without a subcommand it is info | shadowhalloween.house |
| /halloween house create [x y z] [label] | Opens your house on the door, trapdoor or bell you are looking at (or at x y z, within 6 blocks). It opens during the event and already in the TEASER, to get it ready. One per player (player-houses.max-per-player), more with shadowhalloween.house.multiple.<n>. With require-build-permission: true only where you can build: ShadowRegions decides, then ShadowSkyBlock, ShadowOneBlock and ShadowAcidIsland; with none of them nobody decides, and any door can be taken | shadowhalloween.house |
| /halloween house stock <n> [#id] | Moves n candy from your balance to the house's stock. A house holds 5,000 at most (max-stock) | shadowhalloween.house |
| /halloween house treat <n> [#id] | How much candy each visitor gets: from 5 to 20 (treat-range), 10 by default | shadowhalloween.house |
| /halloween house trick <trick|none> [#id] | The trick for whoever knocks when the stock is not enough for a treat: bats, float, pumpkin or hiss by default (player-houses.tricks; not the thief). With none the server picks one of its tricks at random. A new house starts with the first one in the list | shadowhalloween.house |
| /halloween house remove [#id] | Closes the house: the stock goes back to your balance | shadowhalloween.house |
| /halloween course | The ready timed courses, each with your best time and the record | shadowhalloween.courses |
| /halloween course <id> | A course: how many checkpoints it has, the time limit and where the start is (world and coordinates) | shadowhalloween.courses |
| /halloween course leave | Stops the run in progress; your previous helmet goes back in its place | shadowhalloween.courses |
| /halloween scares [off|low|normal] | How much the event scares you. low: only the light scares and never the ones with a flash; off: nothing. Without an argument it says the current level. It stays saved for good | shadowhalloween.use |
| /halloween rewards | Collects the pending rewards and opens the rewards menu, with the two columns "Score thresholds" and "Leaderboard" | shadowhalloween.use |
| /halloween history | Your past seasons: score, position, achievements, objects found | shadowhalloween.use |
Staff commands The staff commands 78
| Command | What it does | Permission |
|---|---|---|
| /hwa | The administration panel. From the console, the list of subcommands | shadowhalloween.admin |
| /hwa help | The list of subcommands | shadowhalloween.admin |
| /hwa reload | Reloads every file, language and menu, and says how many problems it found | shadowhalloween.admin.reload |
| /hwa integrations [hide] | What the other plugins add: one line each, on or not. With hide it stops showing the hints about the missing suite plugins (integrations.show-suite-hints: false) | shadowhalloween.admin |
| /hwa setup | The setup wizard: an eight-step menu, each step runs its own command | shadowhalloween.admin.setup |
| /hwa setup worlds | The worlds, with a [change] button to include or exclude them | shadowhalloween.admin.setup |
| /hwa setup world <world> | Includes or excludes a world (worlds.include in config.yml) | shadowhalloween.admin.setup |
| /hwa setup hub [radius] | The hub where you stand, and the radius of the night around it (0–512, 96 by default). It asks for confirmation | shadowhalloween.admin.setup |
| /hwa setup hunt [hunt] | Scatters 25 hunt objects (pumpkins by default) within 80 blocks of the hub, then shows them to you highlighted. It asks for confirmation | shadowhalloween.admin.setup |
| /hwa setup summary | The summary: hub, houses, hunt objects, cauldron, arena, phase | shadowhalloween.admin.setup |
| /hwa export <quests|crazychest|battlepass|chatgames> | Example files for the other plugins, in plugins/ShadowHalloween/exports/. It never writes into the other plugins' folders | shadowhalloween.admin.setup |
| /hwa event [status] | The phase, the season, whether the calendar or a command decides it, how long until the next change, the modules switched on | shadowhalloween.admin.event |
| /hwa event start | Switches the event on for everyone, now (RUNNING phase) | shadowhalloween.admin.event |
| /hwa event stop | Switches the event off for everyone (OFF phase) | shadowhalloween.admin.event |
| /hwa event phase <TEASER|RUNNING|PEAK|AFTERGLOW|OFF> | Forces a phase. AFTERGLOW, if the final rewards have not been delivered yet, asks for confirmation: it is the step that delivers them | shadowhalloween.admin.event |
| /hwa event resume | Gives the phases back to the calendar. A phase forced by hand stays even after a restart, until you type this | shadowhalloween.admin.event |
| /hwa event preview [on|off] | The event only for you: the others get nothing, not even the hub and cauldron holograms, which while the event is off only whoever is in preview can see. Without an argument, it toggles | shadowhalloween.admin.event |
| /hwa wand [hunt|house|zone|anchor|decor|arena] | The wand (a soul torch). The F key changes mode, the action bar says which | shadowhalloween.admin.wand |
| /hwa hunt [list] | The hunts, with how many objects each one has | shadowhalloween.admin.hunt |
| /hwa hunt create <id> | A new hunt, which becomes the selected one | shadowhalloween.admin.hunt |
| /hwa hunt delete <hunt> | Removes a hunt and its objects. From 5 objects up it asks for confirmation | shadowhalloween.admin.hunt |
| /hwa hunt select <hunt> | Picks the hunt the wand and the commands work on | shadowhalloween.admin.hunt |
| /hwa hunt add <hunt> [x y z [HEAD|BLOCK|DISPLAY]] | An object. If the hunt uses heads and there is already a block at that spot, it marks that block instead of placing a head in it | shadowhalloween.admin.hunt |
| /hwa hunt remove <id | x y z> | Removes an object | shadowhalloween.admin.hunt |
| /hwa hunt show <hunt> | The objects highlighted for 60 seconds, only for you | shadowhalloween.admin.hunt |
| /hwa hunt tp <id> | Takes you to an object | shadowhalloween.admin.hunt |
| /hwa hunt scatter <hunt> [count] [radius] [here] | Scatters objects around the hub (or around you, with here): 25 by default (from 1 to 200) within 80 blocks (from 8 to 128) | shadowhalloween.admin.hunt |
| /hwa hunt reset <player> [hunt] | Resets a player's finds, in one hunt or in all of them | shadowhalloween.admin.hunt |
| /hwa hunt export <hunt> | Writes the positions to exports/hunt-<hunt>.yml | shadowhalloween.admin.hunt |
| /hwa hunt import <hunt> | Reads exports/hunt-<hunt>.yml back and adds those objects | shadowhalloween.admin.hunt |
| /hwa house [list] | The trick-or-treat houses, with the owner of players' houses and the linked NPC (citizens:<id>, essentials:<id> or host@x,y,z for one of our hosts) | shadowhalloween.admin.house |
| /hwa house add [x y z [world [label]]] | Registers a house: a door, a trapdoor, a bell or any block (not air) | shadowhalloween.admin.house |
| /hwa house scan [radius] | Looks for the doors around you (64 by default, from 8 to 128) and lists them with [add] and [add all] | shadowhalloween.admin.house |
| /hwa house add-all | Registers every door found by the last scan | shadowhalloween.admin.house |
| /hwa house npc [label] | One of our NPC houses where you stand: a mannequin with a lit pumpkin on its head, not persistent | shadowhalloween.admin.house |
| /hwa house link <id | label | x y z> | Links to a house the nearest NPC of another plugin, within 8 blocks: a Citizens one (by its id) or a ShadowEssentials one (by its NPC id, which does not change across restarts). If there is none, it places one of our hosts where you stand: a mannequin with a lit pumpkin on its head, not persistent. Clicking the NPC counts as knocking on the door: three clicks in 4 seconds (right click with Citizens, or left with knock.input: PUNCH). An NPC house (house npc) does not get a second host: if no other plugin's NPC is nearby, the link fails and the command says so | shadowhalloween.admin.house |
| /hwa house unlink <id | label | x y z> | Unlinks the NPC from the house; our host, if there was one, disappears | shadowhalloween.admin.house |
| /hwa house remove <id | label | x y z> | Removes a house. If it belongs to a player it closes it, and the stock goes back to the owner even if they are offline | shadowhalloween.admin.house |
| /hwa house reset-cooldowns [player] | Lets one player, or everyone, knock again today | shadowhalloween.admin.house |
| /hwa zone [list] | The haunted zones with presets, triggers and anchors, and the presets that exist | shadowhalloween.admin.zone |
| /hwa zone create <id> [x1 y1 z1 x2 y2 z2 | region:<id> | worldguard:<id>] | A zone: a cuboid (the coordinates, or without them the wand selection), a ShadowRegions region, or a WorldGuard region (worldguard:<id>, also wg:<id>) in the world you are in: of any shape, because WorldGuard decides who is inside. If WorldGuard is missing, or the region does not exist in that world, the command says so | shadowhalloween.admin.zone |
| /hwa zone delete <zone> | Removes a zone | shadowhalloween.admin.zone |
| /hwa zone select <zone> | Picks the zone the wand and the commands work on | shadowhalloween.admin.zone |
| /hwa zone preset <zone> add|remove <preset> | Adds or removes a scare sequence | shadowhalloween.admin.zone |
| /hwa zone trigger <zone> add|remove <enter|point|interact|interval:30s> | Adds or removes a trigger. The interval takes any duration (interval:2m) | shadowhalloween.admin.zone |
| /hwa zone anchor <zone> add|remove <name> [x y z] | A named point inside the zone (without coordinates, where you stand). Actions use it with at=@name | shadowhalloween.admin.zone |
| /hwa zone test <zone> [player] | Runs the zone on you or on a player. It skips the waits but respects their scare level | shadowhalloween.admin.zone |
| /hwa course [list] | The timed courses, with the checkpoints, the world and whether they are ready (ready = start and finish placed) | shadowhalloween.admin.zone |
| /hwa course create <id> | A new course, in the world you are in. If courses.yml does not have its rules yet it adds them (name, no pumpkin on the head, 50 candy the first time and 10 a day), to be changed there. A course already written in courses.yml, like maze and pumpkin_parkour, already exists: it is not created, it only needs the positions | shadowhalloween.admin.zone |
| /hwa course delete <id> | Removes a course: the positions, its rules in courses.yml and the times recorded | shadowhalloween.admin.zone |
| /hwa course start <id> [x y z] | The start: the block you are looking at (within 6) or the one at x y z. A run starts by stepping on it (a pressure plate) or with a right click | shadowhalloween.admin.zone |
| /hwa course finish <id> [x y z] | The finish | shadowhalloween.admin.zone |
| /hwa course checkpoint <id> add [x y z] | The next checkpoint: they must be reached in the order you add them | shadowhalloween.admin.zone |
| /hwa course checkpoint <id> remove <n> | Removes checkpoint number n (counting from 1) | shadowhalloween.admin.zone |
| /hwa course checkpoint <id> clear | Removes every checkpoint | shadowhalloween.admin.zone |
| /hwa course tp <id> | Takes you to the start | shadowhalloween.admin.zone |
| /hwa course reset <player> [id] | Resets a player's times for this season, on one course or on all of them | shadowhalloween.admin.zone |
| /hwa boss [status] | The boss in progress (phase, health, players, whether it is a test), or every boss with its engine (BUILTIN, SHADOWCUSTOMIZER or MYTHICMOBS) and its arena | shadowhalloween.admin.boss |
| /hwa boss spawn <id> [here] [--rewards] | Spawns a boss in its arena, or where you stand with here. It is a test: no rewards, unless --rewards | shadowhalloween.admin.boss |
| /hwa boss kill | Kills the boss in progress | shadowhalloween.admin.boss |
| /hwa boss arena set [id] | The centre of the arena where you stand: for one boss, or without an id the default one, which applies to every boss without an arena of its own. With ShadowRegions it suggests making it a no-build region | shadowhalloween.admin.boss |
| /hwa boss next | The next scheduled boss, and when | shadowhalloween.admin.boss |
| /hwa cauldron [status] | The cauldron's total, goal, round and position | shadowhalloween.admin.cauldron |
| /hwa cauldron set | The cauldron you are looking at, or a new one two blocks in front of you. It asks for confirmation | shadowhalloween.admin.cauldron |
| /hwa cauldron goal <n> | The goal of the current round; the following rounds grow from there | shadowhalloween.admin.cauldron |
| /hwa cauldron reset | Resets the total and starts again from the first round | shadowhalloween.admin.cauldron |
| /hwa candy give|take|set|reward <player> <n> [reason] | Works offline too. give, take and set change only the balance; reward is a reward and also counts towards the score. Every operation ends up in the console | shadowhalloween.admin.candy |
| /hwa decorate [radius] [density] [preset] | Decorates around you: radius 16 by default (from 2 to 128), density 0.08, preset spooky or pumpkins (ambience.yml). Loaded chunks only, 40 blocks per tick, everything in the block ledger | shadowhalloween.admin.decorate |
| /hwa decorate undo | Undoes the last decoration pass | shadowhalloween.admin.decorate |
| /hwa cleanup [blocks|entities|holograms|all] | Puts everything back (all by default). First it counts what it will remove, then asks for [ CONFIRM ]; from the console it starts at once | shadowhalloween.admin.cleanup |
| /hwa rewards final [preview] | The thresholds, the leaderboard and whether the final rewards have already been delivered | shadowhalloween.admin.rewards |
| /hwa rewards final deliver | Delivers the season's final rewards now. It asks for confirmation | shadowhalloween.admin.rewards |
| /hwa rewards final redeliver <player> | Delivers the final rewards to a player again | shadowhalloween.admin.rewards |
| /hwa calendar reset <player> | Resets a player's calendar (offline too) | shadowhalloween.admin.calendar |
| /hwa calendar set-day <player> <day> | A test day for an online player, not saved; 0 goes back to the real day | shadowhalloween.admin.calendar |
| /hwa debug [budgets] | Particles per player and in total, entities, spectral mobs, average task cost, milliseconds per tick, governor level, queued blocks, modules switched on | shadowhalloween.admin.debug |
| /hwa debug force-outcome <TREAT|TRICK|off> | The result of the next knock, for testing | shadowhalloween.admin.debug |
| /hwa debug boss-hurt <percent> | Brings the health of the boss in progress to that percentage, to test the phases | shadowhalloween.admin.debug |
| Node | What it grants | By default |
|---|---|---|
| shadowhalloween.use | The /halloween menu and the basic commands (candy, treat, scares, rewards, history, help) | Everyone |
| shadowhalloween.shop | Open the event shop | Everyone |
| shadowhalloween.calendar | Open the October calendar | Everyone |
| shadowhalloween.hunt | See the hunts and your progress | Everyone |
| shadowhalloween.hunt.hint | Ask for a hint towards the nearest hidden object | Everyone |
| shadowhalloween.quests | See today's event quests | Everyone |
| shadowhalloween.costumes | Open the wardrobe and wear costumes | Everyone |
| shadowhalloween.cauldron | Open the witch's cauldron, donate and brew | Everyone |
| shadowhalloween.boss | See the next boss and join the arena | Everyone |
| shadowhalloween.top | See the leaderboards | Everyone |
| shadowhalloween.achievements | See the season's achievements | Everyone |
| shadowhalloween.house | Open your own trick-or-treat house and fill it with your candy | Everyone |
| shadowhalloween.courses | See the timed courses and leave a run | Everyone |
| shadowhalloween.candy.others | See another player's candy | Operators |
| shadowhalloween.bypass.cooldown | No wait between two hunt hints | Operators |
| shadowhalloween.bypass.caps | No daily cap on candy from mobs, pumpkins and carving | Operators |
| shadowhalloween.admin | The /hwa panel and the administration commands | Operators |
| shadowhalloween.admin.reload | Reload files and languages | Operators |
| shadowhalloween.admin.setup | The setup wizard, the integrations page and the exports for other plugins | Operators |
| shadowhalloween.admin.event | Start, stop, force a phase, resume the calendar, preview | Operators |
| shadowhalloween.admin.wand | The setup wand | Operators |
| shadowhalloween.admin.hunt | Create hunts and place, scatter, show and reset their objects | Operators |
| shadowhalloween.admin.house | Register trick-or-treat houses, link NPCs to them and close players' houses | Operators |
| shadowhalloween.admin.zone | Haunted zones, their presets, triggers and anchors, and the timed courses | Operators |
| shadowhalloween.admin.boss | Spawn and kill the boss, and place its arena | Operators |
| shadowhalloween.admin.cauldron | Place the cauldron and change its goal | Operators |
| shadowhalloween.admin.candy | Give, take, set and reward candy | Operators |
| shadowhalloween.admin.decorate | Decorate around you and undo the last pass | Operators |
| shadowhalloween.admin.cleanup | Put back every block the event placed and remove its entities | Operators |
| shadowhalloween.admin.rewards | Preview, deliver and redeliver the final rewards | Operators |
| shadowhalloween.admin.calendar | Reset a player's calendar or set their test day | Operators |
| shadowhalloween.admin.debug | Budgets, forced trick-or-treat outcome, boss health | Operators |
| shadowhalloween.* · 32 children | Every permission of the plugin, bypasses included | Operators |
Screenshots
No screenshots
There are no screenshots yet. When there are they show up here, and in the meantime saying so beats filling the space.
What it is ShadowHalloween
Candy from night mobs, trick-or-treat doors and players' own houses, hidden-object hunts, timed courses and a three-phase boss, a cauldron the whole server fills, costumes kept forever and an October calendar. It starts and stops by itself every year and puts every block back when you clean up.
Instead of
ShadowHalloween covers what you do today with ScaryHalloween, Pumpkin Hunt, Halloween Trick Or Treating — in one jar, with no dependencies to install first.
How to install it
- Copy the jar into the
pluginsfolder of your Paper server. - Restart. The plugin writes its own configuration.
Supported plugins
19 declared in the descriptor PL PlaceholderAPI Optional
SH ShadowControl Optional
SH ShadowQuests Optional
SH ShadowBattlePass Optional
SH ShadowGames Optional
SH ShadowCustomizer Optional
SH ShadowRegions Optional
SH ShadowEconomy Optional
SH ShadowCrazyChest Optional
SH ShadowEssentials Optional
VA Vault Optional
SH ShadowCosmetics Optional
SH ShadowBlocker Optional
SH ShadowSkyBlock Optional
SH ShadowOneBlock Optional
SH ShadowAcidIsland Optional
MY MythicMobs Optional
CI Citizens Optional
WO WorldGuard Optional
None of these has to be installed, except the ones marked required: when it is there, ShadowHalloween uses it; when it is missing, it works all the same.