📜 ScrollsRPG — Description

ScrollsRPG is a Paper 1.21.11 plugin that transforms Minecraft into an RPG power system. Each player receives a single, soul-bound magical Scroll upon joining — a legendary artifact granting elemental mastery.

🎯 Core System

Table

</header>

Feature	Description
One Scroll Per Player	Each player gets ONE random scroll on first join. Cannot be dropped or stored.
Soul-Bound	The scroll is locked to your inventory — impossible to drop, move to chests, or give away.
Death = Drop	If killed, your scroll drops on the ground. The killer can loot it and gain your power.
Persistent Data	Scroll assignments saved in `scrolls.yml` — survives plugin reloads and version updates.
Bell Animation	Epic joining ceremony with bell sounds, ascending spiral particles, and golden titles.

📜 The 6 Elemental Scrolls

Table

</header>

Scroll	Element	Tag	Title
INFERNO	Fire	ULTIMATE	Lord of Fire
ALTIS	Water	—	Lord of Tides
TERRA	Earth	—	Guardian of Earth
VOLTIS	Lightning	—	Child of Thunder
UMBRA	Shadow	—	Lord of Shadows
AETHER	Light	ULTIMATE	Celestial Disciple

⚔️ Power Structure (Per Scroll)

Each scroll grants 7 powers:

Table

</header>

Type	Count	Activation
Passives	2	Always active (no action needed)
Attacks	3	Click in Power Menu
Ultimate	1	Shift + Right-Click with scroll
Support	1	Click in Power Menu
Super Ultimate	1	Shift + Right-Click (ULTIMATE tag only)

🎮 Controls

Table

</header>

Action	Result
Right-Click (holding scroll)	Opens Power Menu GUI
Click attack/support in menu	Casts the selected power
Shift + Right-Click	Casts Ultimate (or Super Ultimate if ULTIMATE tag)

🔥 Example Powers

INFERNO (Lord of Fire):

Passive 1: Burning aura — enemies within 3 blocks catch fire
Passive 2: Permanent fire resistance
Attack 1: Fireball projectile
Attack 2: Wall of fire
Attack 3: Meteor strike (explosion + fire)
Ultimate: Fire Dragon — 20-block line of flames
Support: Fire shield for nearby allies
Super Ultimate: Fire Apocalypse — expanding fire rings, central explosion, lightning

AETHER (Celestial Disciple):

Passive 1: Slow falling when falling
Passive 2: Glow effect on nearby allies
Attack 1: Light beam
Attack 2: Celestial arrows (×5)
Attack 3: Divine judgment (heavy damage zone)
Ultimate: Ascension — slow fall + regeneration + absorption + resistance
Support: Blessing — buffs all nearby allies
Super Ultimate: Divine Judgment Ultimate — lightning on all enemies, 500 totem particles, 20 random strikes

🔑 Admin Commands

Table

</header>

Command	Description
`/scroll give <player> <type>`	Give a specific scroll to a player
`/scroll change <player> <type>`	Change a player's scroll (removes old, gives new)
`/scroll reset <player>`	Remove a player's scroll completely

💾 Data Persistence

Player scroll data is saved in:

plain

Copy

</header>

plugins/ScrollsRPG/scrolls.yml

Even if you delete the plugin JAR and install a new version, all player scrolls are preserved.

⚙️ Technical

API: Paper 1.21.11
Java: 21+
No Resource Pack Required — all effects use native particles, sounds, and Adventure text components
MiniMessage — gradient names, colored lore, animated titles
PersistentDataContainer — clean NBT storage on items

🎨 Visual Style

Enchantment glint on all scrolls (native glow, no RP)
Gradient colored names using MiniMessage (<<gradient:#FF4500:#8B0000>INFERNO</gradient>)
Custom lore with rarity stars and power descriptions
Particle effects for every power cast
Sound immersion — bell resonance, thunder, explosions, ambient loops

Author: PixelAi75 (Astran)

Astran Scrolls