Morale Boost

# Morale Boost **A cooperative team morale system for Minecraft servers** _This mod is used for RP with admins as gamemasters. Use function morale:add commands to give morale._ --- ## Overview Morale Boost adds a shared **Team Morale** score that rises and falls based on what your team does together. Sleep through the night, and morale climbs. Watch a teammate die, and the whole team feels it. Morale directly affects every player's movement speed and attack speed, and going beyond the cap unlocks a buff state that makes the whole team faster and hit harder. Designed for cooperative survival and medieval/roleplay servers. --- ## Features - **Shared morale score** — one value for the whole team, ranging from `0` to `150` - **Death penalty** — every death costs the team `-5` morale, with atmospheric flavor messages broadcast to all players - **Sleep bonus** — each player who sleeps in a bed grants `+1` morale - **Passive drain** — morale above `100` slowly drains back down over time (1 point per minute) - **Overflow buff** — morale above `100` grants all players a `+20%` attack speed and `+10%` movement speed bonus - **Gradual penalties** — low morale applies increasing attack speed and movement speed debuffs across multiple thresholds - **Debug command** — built-in debug function for server admins --- ## Morale Thresholds ### Penalties (morale ≤ 100) | Morale Range | Attack Speed | Movement Speed | |:---:|:---:|:---:| | 101+ | +20% *(overflow buff)* | +10% *(overflow buff)* | | 90–100 | — | — | | 85–89 | −7% | — | | 80–84 | −14% | — | | 75–79 | −21% | −3% | | 70–74 | −28% | −6% | | 65–69 | −35% | −9% | | 60–64 | −35% | −12% | | 55–59 | −35% | −15% | | 50–54 | −35% | −18% | | 45–49 | −35% | −21% | | 40–44 | −35% | −24% | | 35–39 | −35% | −27% | | ≤ 34 | −35% | −30% | Morale is capped at a **maximum of 150** and a **minimum of 0**. --- ## Morale Changes at a Glance | Event | Morale Change | |---|:---:| | Player death | −5 | | Player sleeps in bed | +1 | | Overflow drain (above 100) | −1 per minute | > The overflow drain only ticks while morale is above 100. Once it returns to 100 or below, the timer resets. --- ## Commands All commands require operator permissions (`/op`). ### Check Morale Status ``` /function morale:status ``` Displays the current team morale to all players, color-coded by range. ### Manually Adjust Morale ``` /function morale:add_morale_1 /function morale:add_morale_5 /function morale:add_morale_10 /function morale:add_morale_15 /function morale:add_morale_25 ``` Adds the specified amount to team morale. Caps at 150. ### Debug Info ``` /function morale:debug ``` Broadcasts an admin-facing debug panel showing current morale, overflow timer (in ticks), and cumulative death count. --- ## Installation 1. Download `Morale_Boost_release.zip` 2. Place the `.zip` file into your world's `datapacks` folder: ``` <world_folder>/datapacks/ ``` 3. In-game or in the server console, run: ``` /reload ``` The pack initializes automatically on load. Morale starts at `100` if no previous value exists. --- ## Compatibility | Version | Status | |---|:---:| | Minecraft 26.2 (pack format 107) | ✅ Supported | | Minecraft 1.21.11-1.21.5 | Maybe Supported? | | Minecraft 1.20.x and below | ❌ Not supported | > This datapack uses the `attribute modifier add` command syntax introduced in 1.21. It will not function correctly on older versions. --- ## Notes for Server Owners - The death detection system works by comparing a running total of all player deaths each tick. - The `on_join` advancement uses `minecraft:tick` as its trigger, which fires once on a player's first tick. It is automatically revoked after granting, so it re-fires correctly if a player re-joins. - There is no GUI or boss bar — morale feedback is delivered through chat messages and the `/function morale:status` command. --- Made for the need of **Toba Garage Gamedev Department** --- ## License GNU GPL v3