# RG Memory SMP `RG_Memory_SMP` is a Paper plugin for Minecraft `1.20.x` that turns player survival into a memory-based progression system. Players start with a configurable amount of memory. Deaths reduce memory, certain kills restore it, and falling into lower memory tiers disables more parts of the game. If a player reaches `0` memory, they are eliminated from the server until another player completes a revival ritual. ## What It Adds - A configurable memory system with loss on death and gain from selected kills - Five progression tiers: `High`, `Medium`, `Low`, `Critical`, and `Danger` - Automatic elimination when a player reaches `0` memory - Bound player heads dropped on elimination for revival crafting - Custom items: - `Memory Crystal` - `Echo Fragment` - `Forgotten Relic` - `Unban Head` - A ritual-based revival system with bossbar, particles, sounds, and failure conditions - Memory-based restrictions for potions, enchanting, anvils, Nether access, Ender Chests, villager trading, chat, brewing, and Totems of Undying - Team-based and gradient nametags - In-game item and recipe GUIs via `/memory items` - Automatic recipe discovery in the recipe book - Configurable Memory Crystal chest loot injection for supported structures ## Gameplay Loop 1. Players begin with a starting memory value. 2. Death reduces memory. 3. Killing players, Wardens, or Withers restores memory. 4. Memory Crystals can be used to restore a larger chunk of memory. 5. As memory drops, more features become restricted. 6. At `0` memory, the player is marked `OUT`, kicked, and blocked from rejoining. 7. Their bound head can be used to create a player-bound Forgotten Relic. 8. That relic creates an Unban Head for the eliminated player. 9. Place the Unban Head and protect it through the full ritual duration. 10. If the ritual succeeds, the player is revived and can join again with restored memory. ## Memory Tiers Default thresholds from the included config: - `80+`: full access, including positive potions - `60-79`: no enchanting or anvils - `40-59`: no Nether access or Ender Chests - `20-39`: no chat, villager trading, or Totems of Undying - `0-19`: danger zone - `0`: eliminated from the SMP Default memory changes: - Normal death: `-10` - PvP death: `-15` - Lava or fire death: `-25` - Void death: `-25` - Player kill: `+10` - Warden kill: `+20` - Wither kill: `+20` - Memory Crystal use: `+25` ## Custom Items ### Memory Crystal - Restores memory on right-click - Can be injected into natural structure chest loot - Used as an ingredient in the Forgotten Relic recipe ### Echo Fragment - Crafted from Echo Shards and a Diamond Block - Used in the Forgotten Relic recipe ### Forgotten Relic - Crafted item used to begin the revival chain - Becomes bound to the eliminated player when crafted with their head - Opens a revive GUI when right-clicked ### Unban Head - Created from a Forgotten Relic for a specific eliminated player - Placing it starts the revival ritual - Cannot be freely repurposed for another player ## Revival Ritual The revival ritual is the core recovery mechanic. - Only one ritual can be active at a time - Starting a ritual broadcasts it to the whole server - All online players can see the ritual bossbar - The action bar shows the ritual owner, coordinates, and remaining time - Default ritual duration is `600` seconds - Successful revival restores the eliminated player to `30` memory by default By default, the ritual fails if: - The ritual head is broken - An explosion happens near the ritual - The ritual owner dies - The server restarts If a ritual fails, the revival attempt is canceled and the head is removed. In some failure cases, a head item is dropped back into the world. ## Recipes ### Echo Fragment Crafting shape: ```text AEA EDE AEA ``` - `E` = `ECHO_SHARD` - `D` = `DIAMOND_BLOCK` ### Forgotten Relic Crafting shape: ```text MAM ENE MHM ``` - `M` = `Memory Crystal` - `E` = `Echo Fragment` - `N` = `NETHER_STAR` - `H` = `PLAYER_HEAD` If the player head belongs to an eliminated player, the crafted relic becomes bound to that player. ## Commands Player commands: - `/memory` - `/memory help` - `/memory items` - `/memory items ` Admin commands: - `/memory set ` - `/memory give [target_for_unban]` - `/memory out ` - `/memory unban ` - `/memory reload` - `/memory team set ` - `/memory team remove ` - `/memory info ` Aliases: - `/mem` - `/memorysmp` ## Permissions - `memorysmp.player`: granted to all players by default - `memorysmp.admin`: admin tools and management commands, default `op` ## Configuration Highlights The included `config.yml` lets you change: - Starting, minimum, and maximum memory - Death penalties and kill rewards - Tier thresholds - Team names and gradient colors - Nametag formatting - Ritual duration, bossbar style, and revived memory - Whether ritual failure happens on explosions, death, head break, or restart - Custom item names, lore, materials, glow, and custom model data - Memory Crystal spawn chances and allowed loot tables - All player-facing messages Default loot table support includes structures such as: - Abandoned mineshafts - Bastions - Buried treasure - Desert pyramids - End cities - Strongholds - Woodland mansions - Ancient cities - Trail ruins - Villages ## Requirements - Server software: `Paper` - Minecraft API target: `1.20` - Paper API dependency used in build: `1.20.4-R0.1-SNAPSHOT` - Java: `17` ## Installation 1. Build the plugin jar or use the packaged release jar. 2. Place the jar in your server `plugins` folder. 3. Start the server once to generate the config and data folders. 4. Review and edit `plugins/RG_Memory_SMP/config.yml` to fit your SMP. 5. Restart the server or use `/memory reload`. ## Data Storage - Player data is saved per player in `plugins/RG_Memory_SMP/playerdata` - Stored data includes memory, OUT state, revived status, team, and pending ritual respawn location ## Best Fit This plugin is a strong fit for: - Hardcore-style SMPs - Content-focused private servers - Story-driven survival servers - Custom progression servers that want social revival mechanics instead of standard bans ## Notes For Modrinth - This project is a `Paper` plugin, not a Fabric or Forge mod - Best uploaded under a Bukkit/Paper/Spigot-compatible project category - The main gameplay hook is memory-based elimination plus ritual revival ## Credits - Author: `RishavTheOG`

RishavTheOG

Organizations