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:

AEA
EDE
AEA

• E = ECHO_SHARD
• D = DIAMOND_BLOCK

Forgotten Relic

Crafting shape:

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 <crystal|echo|relic|unbanhead>

Admin commands:

• /memory set <player> <amount>
• /memory give <crystal|echo|relic|unbanhead> <player> [target_for_unban]
• /memory out <player>
• /memory unban <player>
• /memory reload
• /memory team set <player> <team>
• /memory team remove <player>
• /memory info <player>

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