PaperLuckyBlock

**--- Plugin Overview | Property | Value | |----------|-------| | **Name** | PaperLuckyBlocks | | **Version** | 1.0.0 | | **API** | Paper 1.21.1 - 1.21.8 | | **Java Version** | 21 | | **Dependencies** | None (standalone) | What This Plugin Does PaperLuckyBlocks faithfully recreates the classic Lucky Block Mod experience for Paper servers. Players can craft, place, and break Lucky Blocks to trigger random outcomes ranging from treasure drops to dangerous traps. The plugin also includes three special Lucky Items with unique combat abilities. Core Mechanics ``` ┌─────────────────────────────────────────────────────────────┐ │ LUCKY BLOCK FLOW │ ├─────────────────────────────────────────────────────────────┤ │ Craft Lucky Block → Place Block → Break Block │ │ ↓ ↓ ↓ │ │ 8 Gold + Dropper Stores Luck Triggers Outcome │ │ Level Based on Luck │ └─────────────────────────────────────────────────────────────┘ ``` --- Lucky Block System The Lucky Block Item | Property | Description | |----------|-------------| | **Material** | Player Head (Skull) | | **Texture** | Custom Base64 yellow question mark skin | | **Stackable** | Yes (64) | | **Craftable** | Yes | | **Data Storage** | PersistentDataContainer | Visual Appearance ``` ┌─────────────────────────┐ │ ★ Lucky Block ★ │ ← Gold bold title │ │ │ Luck: +50 │ ← Color-coded luck value │ │ ← Visual luck bar │ │ │ "Feeling lucky..." │ ← Dynamic description │ │ │ Break to reveal! │ ← Action hint └─────────────────────────┘ ``` Luck Levels Explained | Range | Color | Description | Outcome Tendency | |-------|-------|-------------|------------------| | +75 to +100 | Dark Green | Fortune favors you greatly! | Almost always positive | | +50 to +74 | Green | The odds are in your favor | Mostly positive | | +25 to +49 | Yellow | Feeling a bit lucky... | Slightly positive | | 0 to +24 | White | Balanced between fortune and fate | Neutral | | -25 to -1 | Gold | Tread carefully... | Slightly negative | | -50 to -26 | Red | Misfortune looms ahead | Mostly negative | | -100 to -51 | Dark Red | Cursed by terrible luck! | Almost always negative | Crafting Recipe ``` ┌─────┬─────┬─────┐ │ │ │ │ = Gold Ingot ├─────┼─────┼─────┤ │ │ │ │ = Dropper ├─────┼─────┼─────┤ │ │ │ │ Result: Lucky Block (Luck: 0) └─────┴─────┴─────┘ ``` Placement & Breaking **When Placed:** - Block location and luck level are stored in memory - Enchantment particles appear - Chime sound plays - Block becomes a player head with custom texture **When Broken:** - Normal drops are cancelled - Break effects play (golden particles, level-up sound) - Title appears showing outcome name - Random outcome executes after 0.5 second delay - Luck level influences outcome selection --- ⚔️ Lucky Items Lucky Sword | Property | Value | |----------|-------| | **Base Material** | Golden Sword | | **Attack Damage** | 6.0 (configurable via attributes) | | **Attack Speed** | Standard sword speed | | **Enchantments** | Unbreaking V (hidden glow) | | **Trigger** | Hit any living entity | Lucky Sword Effects | Effect | Chance | Description | |--------|--------|-------------| | **Arrow Stream** | 5% | Fires 5 arrows at the victim with slight spread | | **Vampirism** | 5% | Heals attacker for 3 hearts (6 half-hearts) | | **Blindness** | 5% | Applies Blindness + Slowness to victim | ``` ┌──────────────────────────────────────────────────────┐ │ ✦ Lucky Sword ✦ │ ├──────────────────────────────────────────────────────┤ │ A blade blessed by fortune itself! │ │ │ │ ⚔ Attack Damage: 6 │ │ │ │ Random Effects (5% chance): │ │ ➤ Arrow Stream - Fires 5 arrows │ │ ➤ Vampirism - Heal 3 hearts │ │ ➤ Blindness - Blind the enemy │ └──────────────────────────────────────────────────────┘ ``` Arrow Stream Mechanics - Spawns 5 arrows with 2-tick delay between each - Arrows home toward victim's center mass - Each arrow deals 4.0 damage - Arrows cannot be picked up - Arrows glow for visibility - Critical hit particles on each arrow Vampirism Mechanics - Heals based on config value (default: 6 half-hearts) - Cannot exceed max health - Red dust particles flow from victim to attacker - Heart particles around attacker - Satisfying sound effect Blindness Mechanics - Blindness I for 5 seconds (100 ticks) - Slowness II for 3 seconds (60 ticks) - Witch and smoke particles on victim - Illusioner spell sound --- Lucky Bow | P