Improve main README API documentation with better organization and examples

[Copilot]

The main README's API section lacked clear organization and contained a syntax error, making it difficult for developers to understand how to use the ComboFly Arena API.

Changes

Improved main README API documentation:

• Added clear hierarchical organization with sections: Getting Started, Arena Configuration, Player Management, Kit Management, Broadcasting Messages, and Player Statistics
• Fixed syntax error in Position constructor (missing comma)
• Enhanced all code examples with descriptive inline comments
• Added subsection headers for better navigation
• Improved clarity and readability throughout

Reverted incorrect changes:

• Restored pmforms library README to its original state (was incorrectly modified in earlier commits)

Example

Before:

$pos = new Position(0, 100, 0 $world); /* Syntax error - missing comma */
$arena->setArena($pos);

After:

// Arena Configuration section with clear headers
**Set Arena Spawn Position**

Configure where players spawn when entering the arena.

$pos = new Position(0, 100, 0, $world); // Fixed syntax
$arena->setArena($pos);

The API section now has better organization, fixed syntax errors, and clearer examples for all Arena methods.

Original prompt

Improve the API readme

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[MXJosueDev]

@copilot You only need to chaage the main README

[Copilot]

@copilot You only need to chaage the main README

You're right! I've corrected this. The pmforms README has been reverted to its original state, and I've improved the main README's API section instead with better organization, clearer sections, and fixed the syntax error in the Position constructor. Changes made in commit 6e89752.