Loot Events - SpaceCat97/SpaceCats-Wikis GitHub Wiki

Links

This mod:
Curseforge
Modrinth

Required Mods:
Architectury

Discord: Click here.


Change Log

Click here for the change log.


Description

Loot Events is a server administration tool designed to help admins easily plan and run community loot events for their players. The mod is designed to help streamline loot events.

The main feature, Item Loot, allows you to create an event where items fall from the sky in a designated cubic radial area. Admins can configure everything - from the event location and duration to what items shouldn't drop and how frequently they spawn. The whole system is command-driven, so admins can set up, prepare, and launch events entirely through chat commands without needing to mess with config files mid-game.

The mod also has a couple of anti-cheat measures to keep things fair. It tracks which items each player actually collects during the event and has some simple safeguards to prevent exploitation. There's an easy to use blacklist system that allows you to stop overpowered or game-breaking items from dropping, and various limits on stack sizes and collection amounts to keep things balanced.

There is an extensive choice of configuration items. You can adjust event timers, loot frequency, spawn radius, teleportation settings, and even run events in a different dimension. It's built to handle the logistics of community events so admins can focus on creating fun experiences rather than worrying about technical details or players finding ways to cheat the system.

Essentially, Loot Events is designed to be a turnkey solution for running engaging server-wide events that bring the community together.


Notes

  • If you restart the server, players will lose any unclaimed loot.

Need further help? Check out the examples provided, then reach out to me on discord.


Feature List

  • Currently there is 1 event type available: Item Drop
  • Configure a large range of event parameters, so you can fine-tune your event length, loot amounts and even the announcer name
  • Player teleportation upon event start
  • Smart pickup detection, players can't pick up loot if they have not signed up to the event
  • Loot limits, you can decide how many stacks the player can pick up
  • Config saving, you can configure everything in game using commands, the mod will save your settings for next time!

I have plans to expand this mod further :)


Commands Explained

Tip: If /cle is hard to remember, you can also use /event

Command Description
/cle info Shows mod information
/cle settings Displays a list of current settings
/cle set Change mod settings, please consult the in game command for guidance
/cle blacklistedItems View/modify what items should not be dropped by the event system, please consult the in game command for guidance
/cle prepare Prepare for an event, triggers an announcement
/cle start Starts an event (has validation for settings)
/cle cancel Cancels a prepared/ongoing event
/cle join Join the event
/cle leave Leave the event
/cle players List all the players who have signed up to the event
/cle claim Claim your event rewards
/cle listUnclaimedRewards List all the unclaimed rewards you've earned from an event
/cle allUnclaimedRewards List all players' unclaimed rewards

⚠️ **GitHub.com Fallback** ⚠️