🌌 TheOrbit

A complete recreation of Hypixel's "The Pit" gamemode for Minecraft servers

📋 Table of Contents

• About
• Features
• Installation
• Dependencies
• Commands
• Configuration
• Documentation
• Building
• Contributing
• License

🎮 About

TheOrbit (AstroidOrbit) is a feature-rich Minecraft plugin that brings the beloved "The Pit" gamemode to your server. Engage in fast-paced PvP combat, complete quests, collect mystic items with unique abilities, and progress through an extensive leveling system.

The plugin offers a complete recreation with modern enhancements, including:

• Advanced combat mechanics with mystic weapons and abilities
• Comprehensive quest system with daily and permanent objectives
• Player progression with XP, levels, and prestige system
• Dynamic events (Dragon events, Warden events, etc.)
• Economy system with shops and auctions
• Statistics tracking and leaderboards

✨ Features

⚔️ Combat System

• Mystic Items: 12+ unique weapons and armor pieces with special abilities
• Ability System: 17+ unique abilities including fire, ice, lightning, shadow, and void powers
• Tiered System: 4 tiers (Common, Rare, Epic, Legendary) with increasing power
• Assist System: Earn rewards for assists in combat
• Kill Streaks: Track and reward consecutive kills
• Combat Stats: Comprehensive K/D tracking and statistics

🎯 Quest System

• Daily Quests: Rotating daily objectives for bonus rewards
• Permanent Quests: Long-term goals for dedicated players
• Auto-Enable: Automatic quest activation
• Progress Tracking: Real-time quest progress updates
• Renown System: Earn renown points for completing quests

💎 Mystic Abilities

• Combat Abilities: Ignite, Slow, Lightning Strike, Chain Lightning, Lifesteal, Death Mark
• Area Abilities: Fire Trail, Ice Nova, Void Burst, Gravity Slam, Fire Aura
• Projectile Abilities: Piercing Arrow, Shadow Step
• Defensive Abilities: Resurrection, Armor Shred
• Trigger Types: On-hit, right-click, sneak + right-click, automatic
• Cooldown System: Balanced ability usage with configurable cooldowns

🎪 Events

• Dragon Events: Special boss encounters
• Warden Events: Challenging warden battles
• Event Scheduler: Automated event rotation
• Multipliers: XP and coin bonus events

💰 Economy

• Gold System: Earn gold through combat and quests
• Shops: NPC vendors with various items
• Auction House: Player-to-player trading system
• Mystic Well: Enchant and upgrade your items

📊 Player Progression

• Leveling System: Earn XP to level up
• Prestige System: Reset your level for permanent bonuses
• Statistics: Track kills, deaths, assists, gold earned, and more
• Leaderboards: Compete with other players

🗺️ World Management

• Spawn Protection: Safe zones for new players
• Arena System: Multiple combat zones
• Gold Locations: Strategic points for bonus rewards
• World Borders: Configurable play area

🚀 Installation

1. Prerequisites

   • Java 17 or higher
   • Minecraft server 1.20+
   • Required dependencies (see below)

2. Download

   • Download the latest release from the releases page
   • Or build from source (see Building)

3. Install

   # Place the JAR file in your server's plugins folder
   cp theorbit-3.0.0.jar /path/to/server/plugins/

4. First Run

   • Start your server to generate configuration files
   • Stop the server and configure config.yml and mystics.yml
   • Use /theorbitsetup command to complete the setup wizard

5. Configure

   • Set up spawn points, NPCs, and holograms
   • Adjust gameplay settings in configuration files
   • Configure database connection if needed

📦 Dependencies

Required

• Citizens - NPC management
• FancyHolograms - Hologram displays

Optional

• WorldEdit - World manipulation
• WorldGuard - Region protection
• LuckPerms - Permission management
• PlaceholderAPI - Placeholder support
• TAB - Tablist customization

🎛️ Commands

Player Commands

Command	Description	Permission
/stats [player]	View player statistics	theorbit.stats
/quests	Open quest menu	theorbit.quests
/shop	Open shop menu	theorbit.shop
/mysticwell	Access mystic enchanting	theorbit.mysticwell

Admin Commands

Command	Description	Permission
/theorbit reload	Reload configuration	theorbit.admin
/theorbit setlobby	Set lobby spawn point	theorbit.admin
/theorbit givemystic <player> <mystic>	Give mystic item	theorbit.admin
/theorbit forceevent <event>	Force start an event	theorbit.admin
/theorbitsetup	Run setup wizard	theorbit.admin
/orbitadmin setxp <player> <xp>	Set player XP	theorbit.admin
/orbitadmin addxp <player> <xp>	Add XP to player	theorbit.admin
/orbitadmin setlevel <player> <level>	Set player level	theorbit.admin
/orbitadmin setprestige <player> <prestige>	Set prestige level	theorbit.admin
/orbitadmin resetstats <player>	Reset player stats	theorbit.admin
/givemystic <player> <mystic>	Give mystic item to player	theorbit.admin

Aliases:

• /theorbit → /orbit, /to
• /theorbitsetup → /tsetup, /orbitsetup
• /orbitadmin → /oa, /orbadmin

⚙️ Configuration

Main Configuration (config.yml)

Configure gameplay settings, XP rates, coin rewards, event timings, and more.

xp:
  kill_base: 10
  assist_base: 2
  death_penalty: -5

coins:
  kill_base: 20
  assist_base: 8

Mystic Items (mystics.yml)

Define custom mystic items with abilities, enchantments, and stats.

mystics:
  flame_blade:
    name: "&c&lFlame Blade"
    type: DIAMOND_SWORD
    tier: 1
    abilities:
      - type: IGNITE
        chance: 0.3
        duration: 40

Backup Configuration (backup.yml)

Automatic player data backup settings.

📚 Documentation

Comprehensive guides are available in the docs/ directory:

• Abilities Guide - How to create and configure abilities
• How to Use Abilities - Player guide for using mystic abilities
• Mystic System Overhaul - Complete mystic items documentation
• Assist System - Combat assist system details
• Implementation Summary - Technical implementation overview
• Balancing Changes - Recent balancing updates
• Chat Formatter Guide - Chat formatting documentation

🔨 Building

Build from Source

1. Clone the repository

   git clone https://github.com/theorbit/theorbit.git
   cd theorbit

2. Build with Maven

   mvn clean package

3. Output

   • The compiled JAR will be in target/theorbit-3.0.0.jar
   • Shaded JAR (with dependencies): target/theorbit-3.0.0-shaded.jar

Requirements

• Java Development Kit (JDK) 17+
• Apache Maven 3.6+
• Git

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Guidelines

• Follow Java coding conventions
• Document new features in the appropriate /docs file
• Test thoroughly before submitting
• Keep commits focused and descriptive

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

• Cynive: https://github.com/cynive

🙏 Acknowledgments

• Inspired by Hypixel's "The Pit" gamemode
• Built with Spigot API
• Uses Citizens for NPC management
• Uses FancyHolograms for holograms

📞 Support

For support, feature requests, or bug reports:

• Open an issue on GitHub
• Check existing documentation in the /docs folder
• Review the implementation guides

---

Note: This plugin is a recreation and is not affiliated with Hypixel Inc.