JediTelekinesis ⚔️

A comprehensive Jedi RPG experience for Minecraft. Master the Force, choose your path between Light and Dark, and manipulate the world with advanced physics-based telekinesis.

---

✨ Features

• 🌌 True Telekinesis: Grab entities, hold them in mid-air with collision detection, and throw them with physics-based velocity.
• 🔋 Force System: All abilities consume Force (Mana). Manage your energy or suffer exhaustion.
• ⚖️ Alignment Path: Your actions define you. Earn Light or Dark points based on your combat style to unlock exclusive abilities.
• 🧘 Meditation: Crouch while holding your Force Crystal to regenerate Force faster and focus your alignment.
• 📜 Persistent Data: Player stats (Mana, Unlocked Abilities, Alignment) are saved automatically to local files.
• ⚡ Optimized: Efficient ray-tracing and entity handling for smooth performance.

---

📖 How to Use

Step 1: Obtain the Force Crystal

You need a Force Crystal to channel your abilities. (In plans: add craft in the future)

• Admins: Use /tk to spawn one.
• Players: (Optional) Set force-crystal.material in config to a craftable item.

Step 2: Master the Controls

The Force Crystal reacts to different interactions.

Action	Control	Effect
Telekinesis	Right Click	Grab an entity. Click again to release gently.
Throw	Shift + Right Click	Throw the held entity forcefully away.
Cast Ability	Left Click	Casts your currently selected ability.
Cycle Ability	Swap Hands (F)	Cycles through unlocked abilities (Dash, Lightning, etc.).
Meditate	Hold Shift	Regenerate Force and Alignment points.

Step 3: Choose Your Path

Type /jedi to open the Academy Menu.

• Light Side: Gain points by defeating monsters. Unlocks Force Heal.
• Dark Side: Gain points by attacking villagers or players. Unlocks Force Lightning.

---

🛠 Commands & Permissions

Command	Description	Permission
/telekinesis (or /tk)	Gives a Force Crystal to the player.	jeditelekinesis.command.givecrystal
/jedi (or /force)	Opens the Stats and Abilities menu.	None
/tkrelease	Attempt to break free if you are being held.	jeditelekinesis.command.release
/jeditele reload	Reloads the configuration file.	jeditelekinesis.admin.reload

---

⚙️ Configuration

The config.yml allows you to balance costs, cooldowns, and visuals. Player data is stored in the userdata/ folder.

settings (config.yml)

telekinesis:
  cost: 10.0
  hold-cost-per-second: 3.0
  max-grab-range: 20.0
  throw-strength: 1.7

visuals:
  action-bar:
    enabled: true
    symbol: "|"
    color-filled: "&b"

Data Storage Example (userdata/UUID.yml)

Do not edit this manually while the server is running.

stats:
  max-mana: 100.0
  current-mana: 100.0
  light-points: 52
  dark-points: 10
  unlocked-abilities:
  - force_dash
  - force_push_targeted
  - force_push_aoe
  - force_heal

---

📥 Installation

1. Ensure you are running Spigot/Paper 1.19 or higher.
2. Download the latest release .jar.
3. Drop the file into your server's /plugins folder.
4. Restart the server.

---

May the Force be with you.