Cosmic Wishes is a fully server-side Forge mod that introduces an incredibly powerful, AI-driven Genie into your Minecraft world.

Because this mod relies entirely on Server-Side events and NBT data, vanilla players can join your server and interact with the Genie without needing to download the mod themselves! To gain absolute power, players must first prove their dedication by crafting the ultimate late-game item: The Magic Lamp. Crafted with a Nether Star, Echo Shard, Dragon's Breath, and other legendary materials, this modified glowing Lantern is your key to the cosmos.

✨ Features
The Summoning: Right-clicking the Magic Lamp in the air summons the Genie (a disguised, glowing, invincible Allay) who will loyally follow you across the world.

AI-Powered Wishes: Write your exact desire into a Vanilla Written Book and hand it to the Genie. The mod connects to your own AI API to dynamically generate and execute JavaScript code in real-time to make your wish come true.

The Contract: The Genie grants exactly 3 wishes per player.

The Shattering: Once your final wish is granted, the contract is fulfilled. In a burst of magical smoke and cosmic shards, the lamp shatters in your inventory, and the Genie departs forever.

Multiplayer Ready: The Genie remembers every player! You can hand your lamp to a friend, and the Genie will grant them their own set of 3 wishes without forgetting your count.

⚙️ Configuration Guide
This mod is highly customizable and requires an API key to function. Upon running the mod for the first time, a configuration file will be generated.

How to set up your mod:

Run your server once to generate the config files.

Navigate to your server's config folder.

Open the cosmic_wishes-common.toml file using any text editor (like Notepad).

Locate the Genie API Settings section.

Replace "YOUR_KEY_HERE" with your actual Google AI Studio API key.

(Optional) Adjust the Genie Gameplay Settings to change the maxWishes granted per player, or enable XP costs.

Save the file and restart your server.

(Note: Never share your cosmic_wishes-common.toml file with anyone, as it contains your private API key!)