**🔧 General Commands**
– /astropowers help – Show help information
– /astropowers withdraw – Withdraw a power as a drinkable potion

**👑 Admin Commands**
– /astropowers effect add – Give a player a power
– /astropowers effect remove – Remove a power from a player
– /astropowers effect list – Show all powers of a player
– /astropowers recipe create [ingredient3…] – Create a new recipe (max 9 ingredients)
– /astropowers recipe list – Show all recipes
– /astropowers recipe remove – Remove a recipe
– /astropowers recipe edit – Open interactive recipe editor
– /astropowers gui – Open recipe management GUI
– /astropowers reload – Reload configuration

**🎮 Player Commands**
– /ability1 – Use first ability of primary power
– /ability2 – Use second ability of primary power
– /ability3 – Use first ability of secondary power
– /ability4 – Use second ability of secondary power
– /trust add – Trust a player (prevents negative effects)
– /trust remove – Remove trust from a player

# 🔐 Permissions
**🌟 Public Permissions (Default: true)**
– astropowers.help – Access to help command
– astropowers.withdraw – Withdraw powers as potions
– astropowers.ability – Use ability commands (/ability1-4)
– astropowers.trust – Use trust commands (/trust)
–
**👑 Admin Permissions (Default: op)**
– astropowers.admin – Access to admin commands
– astropowers.effect – Manage player powers
– astropowers.recipe – Recipe management
– astropowers.reload – Reload configuration
– astropowers.gui – Access to GUI commands

**🔧 Permission Hierarchy**
– astropowers.* – All permissions (default: op)
– astropowers.use – Basic commands (default: true)
– Includes: help, withdraw, ability, trust

# 🤖 Keybinds

**Command keys mod**
– You can get keybindes for your abilety’s with the [Commandkeys mod](https://modrinth.com/mod/commandkeys) mod.

# ⚡ Power Details

**# 🕊️ Flying**
Passive: No fall damage
– Ability 1: Give closest player 10 seconds of levitation (2 min cooldown)
– Ability 2: Fly for 30 seconds at walking speed (3 min cooldown)

**💪 Strength**
Passive: Double damage to mobs, shield disabling for 10 seconds against players
– Ability 1: Gain Strength 2 for 2 minutes (5 min cooldown)

**🏃 Speed**
Passive: Always Speed 1, 2x attack speed
– Ability 1: Dash 7 blocks forward (30 sec cooldown)

**🌟 Glitch**
Passive: Glowing effect for other players, 20% chance of blindness on attack
– Ability 1: Teleport 20 blocks in looking direction (1.5 min cooldown)

**👁️ Blindness**
Passive: 25% chance of blindness on attack (5 block vision)
– Ability 1: Give all players in 10 block radius 10 seconds of blindness (2 min cooldown)

**🗿 Warden**
Passive: +2 hearts
– Ability 1: Shoot warden beam that deals 6 hearts damage (1 min cooldown)

**✨ Holy**
Passive: Efficiency 10 and Fortune 4 on all pickaxes
– Ability 1: Become invisible for 20 seconds (30 sec cooldown)
– Ability 2: Gain +2 hearts for 1 minute (1 min cooldown)

**❤️ Heart**
Passive: +5 hearts, every food gives 1 absorption heart
– Ability 1: Restore health to 20 hearts (5 min cooldown)

**🧛 Vampire**
Passive: Lifesteal effect (1 heart per crit hit), fully heal on kill
– Ability 1: Make target bleed (slowness + half heart per second, regardless of armor) (3 min cooldown)

**🏹 Arrow**
Passive: +1 damage to all arrows
– Ability 1: Volley – Shoot 3 arrows simultaneously in spread pattern (30 sec cooldown)
– Ability 2: Barrage – Shoot 20 arrows around you in all directions (3 min cooldown)

**🔥 Fire**
Passive: Fire and lava immune (Fire Resistance effect)
– Ability 1: Fireball – Shoot a fireball like a ghast (1 min cooldown)
– Ability 2: Fire Trap – Set 3×3 blocks under closest opponent on fire (2 min cooldown)

**⚡ Lightning**
Passive: No fall damage (Fall Damage Immunity)
– Ability 1: Lightning Strike – Strike lightning on closest opponent (4 hearts damage, armor bypass) (1 min cooldown)
– Ability 2: Lightning Launch – Launch yourself 30 blocks into the air (30 sec cooldown)

# 🛠️ Advanced Crafting System

**# 📝 Recipe Management**
– Separate config: Recipes are stored in recipes.yml
– Flexible ingredients: 2-9 ingredients per recipe
– 3×3 crafting table: Full support for all patterns
– Tab completion: All possible items available via TAB
– Automatic registration: New recipes are immediately available

**🔮 Ritual System**
– Players can craft powers by starting a 20-minute ritual. Upon completion, a power potion is – dropped that grants the power when consumed.

**📢 Global Announcements**
– When a ritual starts, the entire server is notified
– Boss bars appear in all worlds with:
– Ritual information and player name
– Dimension name (Overworld/Nether/End)
– Exact coordinates (X, Y, Z)
– Real-time countdown timer
– Progress bar that decreases as the ritual progresses

## 📁 Configuration Files

### `powers.yml`
**Power configurations and abilities**
– All 12 unique powers (flying, strength, speed, glitch, etc.)
– Ability cooldowns, durations, and ranges
– Passive effects per power
– Power-specific settings

### `crafting.yml`
**Crafting system and ritual settings**
– Ritual duration and settings
– Particle and sound effects
– Boss bar configuration
– Progress tracking settings

### `general.yml`
**General plugin settings**
– Core plugin settings (max powers, trust system, etc.)
– Performance optimizations
– Security settings
– Database backup settings
– Help command configuration

### `world_border.yml`
**World border configuration**
– Border size and location
– Damage and warning settings
– Auto-setup options

### `messages.yml`
**All plugin messages and text**
– Command usage messages
– Error and info messages
– Power-specific messages
– Help text and explanations

### `logging.yml`
**Logging settings**
– Log levels and destinations
– File management
– What gets logged

### `integrations.yml`
**Third-party plugin integrations**
– Vault, WorldGuard, Essentials
– Integration-specific settings

## 🔧 Editing Configuration

1. **Stop the server** (recommended for safety)
2. **Edit the desired config files** in this directory
3. **Restart the server**
4. **Or use** `/astropowers reload` to reload configurations

#### 🕊️ Flying Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│ Feather │ End Crystal │ Breeze Rod │
├─────────────┼─────────────┼─────────────┤
│Phantom Mem. │Music Disc │Phantom Mem. │
│ │(Otherside) │ │
├─────────────┼─────────────┼─────────────┤
│ Breeze Rod │ End Crystal │ Feather │
└─────────────┴─────────────┴─────────────┘
“`

#### 💪 Strength Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Glistening │Heart of the │Glistening │
│Melon │Sea │Melon │
├─────────────┼─────────────┼─────────────┤
│Nautilus │Heavy Core │Nautilus │
│Shell │ │Shell │
├─────────────┼─────────────┼─────────────┤
│Glistening │Fire Charge │Glistening │
│Melon │ │Melon │
└─────────────┴─────────────┴─────────────┘
“`

#### 🏃 Speed Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Netherite │Prismarine │Netherite │
│Scrap │Shard │Scrap │
├─────────────┼─────────────┼─────────────┤
│Wind Charge │Splash Potion │Wind Charge │
│ │of Speed 2 │ │
├─────────────┼─────────────┼─────────────┤
│Rabbit’s │Blaze Rod │Rabbit’s │
│Foot │ │Foot │
└─────────────┴─────────────┴─────────────┘
“`

#### 🌟 Glitch Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Resin Brick │Pitcher │Resin Brick │
│ │Plant │ │
├─────────────┼─────────────┼─────────────┤
│ TNT │ Boat │ TNT │
├─────────────┼─────────────┼─────────────┤
│Resin Brick │Sticky │Resin Brick │
│ │Piston │ │
└─────────────┴─────────────┴─────────────┘
“`

#### 👁️ Blindness Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Ochre │Obsidian │Ochre │
│Froglight │ │Froglight │
├─────────────┼─────────────┼─────────────┤
│Obsidian │Eye of │Obsidian │
│ │Ender │ │
├─────────────┼─────────────┼─────────────┤
│Ochre │Obsidian │Ochre │
│Froglight │ │Froglight │
└─────────────┴─────────────┴─────────────┘
“`

#### 🗿 Warden Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Calibrated │Crossbow │Calibrated │
│Sculk Sensor │ │Sculk Sensor │
├─────────────┼─────────────┼─────────────┤
│Netherite │Music Disc │Diamond │
│Scrap │(Cat) │Block │
├─────────────┼─────────────┼─────────────┤
│Sculk │Diamond │Sculk │
│Catalyst │Sword │Catalyst │
└─────────────┴─────────────┴─────────────┘
“`

#### ✨ Holy Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Bottle of │Spectral │Bottle of │
│Enchanting │Arrow │Enchanting │
├─────────────┼─────────────┼─────────────┤
│Splash Potion│Enchanted │Splash Potion│
│of Healing 2 │Golden Apple │of Healing 2 │
├─────────────┼─────────────┼─────────────┤
│Bottle of │Netherite │Bottle of │
│Enchanting │Pickaxe │Enchanting │
└─────────────┴─────────────┴─────────────┘
“`

#### ❤️ Heart Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Golden Apple │Diamond │Golden Apple │
├─────────────┼─────────────┼─────────────┤
│Music Disc │Totem of │Music Disc │
│(Otherside) │Undying │(Pigstep) │
├─────────────┼─────────────┼─────────────┤
│Golden Apple │Golden │Golden Apple │
│ │Carrot │ │
└─────────────┴─────────────┴─────────────┘
“`

#### 🧛 Vampire Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Honeycomb │Sea Lantern │Resin Brick │
├─────────────┼─────────────┼─────────────┤
│Sea Lantern │Zombie Head │Sea Lantern │
├─────────────┼─────────────┼─────────────┤
│Resin Brick │Sea Lantern │Honeycomb │
└─────────────┴─────────────┴─────────────┘
“`

#### 🏹 Arrow Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Diamond │Diamond │Diamond │
├─────────────┼─────────────┼─────────────┤
│Anvil │Bow │Enchanting │
│ │ │Table │
├─────────────┼─────────────┼─────────────┤
│Diamond │Diamond │Diamond │
└─────────────┴─────────────┴─────────────┘
“`

#### 🔥 Fire Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Fire Charge │Magma Cream │Fire Charge │
├─────────────┼─────────────┼─────────────┤
│Fire Resist. │Pearlescent │Fire Resist. │
│Potion │Froglight │Potion │
├─────────────┼─────────────┼─────────────┤
│Fire Charge │Echo Shard │Fire Charge │
└─────────────┴─────────────┴─────────────┘
“`

#### ⚡ Lightning Power Recipe
“`
┌─────────────┬─────────────┬─────────────┐
│Lightning │Diamond │Lightning │
│Rod │ │Rod │
├─────────────┼─────────────┼─────────────┤
│Diamond │Trident │Diamond │
├─────────────┼─────────────┼─────────────┤
│Lightning │Diamond Axe │Lightning │
│Rod │ │Rod │
└─────────────┴─────────────┴─────────────┘
“`

**Plugin info**

– The plugin adds **14 unique powers** (Flying, Strength, Speed, Glitch, Blindness, Warden, Holy, Heart, Vampire, Arrow, Fire, Lightning, Atlantis, Adaptive). Each has passive effects and 1–2 active abilities. Players can have **two powers at once** (primary and secondary).
– You use abilities with **/ability1**, **/ability2**, **/ability3**, and **/ability4**. Some powers support an extra mode (e.g. Arrow can use arrows from your inventory); toggle with **/abilitymode <power>**.
– Powers are obtained by **crafting**: put the correct items in a **3×3 crafting table** in the recipe pattern for that power. That **starts a ritual**; recipes are in the config and can be edited via **/astropowers recipe edit <power>** or the GUI.
– **Rituals last 20 minutes** and cannot be cancelled. While a ritual runs, you can move freely. When it finishes, a **power potion is dropped** at the crafting table; the player who picks it up gets that power.
– When a ritual **starts**, the **entire server is notified**: a boss bar appears in all worlds with the power name, your name, dimension (Overworld/Nether/End), coordinates, and a live countdown. A beacon-style particle beam appears at the ritual location.
– **Admins** can give or remove powers without crafting using **/astropowers effect add/remove <player> <power>**.
– Your **current powers are shown in the action bar** above the hotbar. You can switch between resource-pack icons or emoji with **/astropowers texturepack**, and reduce particles/sounds with **/astropowers reducedeffects**.
– **Teams** protect you from each other: teammates do not take damage or negative effects from your abilities. Leaders invite players; members must accept. Team size and limits are configurable.
– Recipes, cooldowns, languages (EN, NL, FR, ES), world border, and potion textures are **configurable**. **PlaceholderAPI** placeholders are available for scoreboards and chat (powers, cooldowns, teams, rituals).

**Support and bug reports:** [Join our Discord](https://discord.gg/Edq7jqGbMp)

—

—

—

—

—

—

—

—

*AstroPowers by Astro Studio’s. For support or bug reports, [join our Discord](https://discord.gg/Edq7jqGbMp).*