CobbleGacha Expanded (Cobblemon Gacha System)

# 🎰 CobbleGacha Expanded

**A feature-rich Cobblemon gacha system with rotating limited banners, rate-up Pokémon, animated pull sequences, history tracking, upcoming banner previews, pity systems, in-game editor tools, and customizable server-side banner management.**

CobbleGacha Expanded turns Pokémon obtaining into a configurable gacha-style experience designed for Cobblemon multiplayer servers.

---

## ✨ Gacha Pulling

Perform single or multi-pulls with animated rarity reveals, themed pull effects, and polished reward presentation. 

**Features include:**

- 🎟️ Single and multi-pulls
- ✨ Animated pull sequences
- 🟣 Ultra and Legendary rarity effects
- ⭐ Rate-up Pokémon
- 💎 Legendary Pokémon can receive **3–6 perfect IVs**
- 📜 Pull history tracking
- 🎴 Improved pull result cards
- 🧬 Pokémon reward cards now display **IV stats directly**
- 🎁 Item and Pokémon results shown in a cleaner card-based layout

---

## 🎴 Multiple Limited Banners

Run several banners at the same time instead of being restricted to a single event.

Each banner can have its own:

- Featured Pokémon
- Rate-up pool
- Background artwork
- Accent colour
- Duration
- Legendary pool
- Theme
- Schedule

The default rotation keeps **3 limited banners active simultaneously**.

---

## 📊 Pokémon Rates

Players can inspect a banner before spending pulls.

The **View Pokémon + Rates** menu displays the Pokémon available from each banner and clearly identifies featured rate-up Pokémon.

### Current special rates

**Legendary:** 0.9%  
**Ultra:** 1.8%

Limited banner featured Pokémon receive an increased rate-up chance.

---

## 🌟 50/50 + Guaranteed Featured Pokémon

Limited Legendary banners use a **50/50 system**.

When a Legendary is pulled:

**50% chance → Featured Legendary**  
**50% chance → Non-featured Legendary**

If you lose the 50/50, your **next Legendary on a limited banner is guaranteed to be featured**.

The guarantee persists between supported limited banners.

---

## 🔄 Automatic Daily Banner Rotation

Server owners do not need to manually schedule every event.

CobbleGacha Expanded automatically maintains:

### 3 active limited banners

All three share the **same 24-hour rotation timer**.

After 24 hours:

**Banners 1–3 → Banners 4–6 → Banners 7–9 → ... → loop**

When the end of the configured banner list is reached, the rotation automatically starts again from the beginning.

New banners added to `banner.order` automatically become part of future rotations.

Rotation state persists through server restarts.

---

## 🔮 Upcoming Banners

Players can preview what is coming before the current rotation ends.

The Upcoming menu automatically previews the **next 9 banners**, covering the next three daily rotations.

It displays:

- Banner artwork
- Time until activation
- Banner duration
- Featured Pokémon
- Rate-up Pokémon previews

Manually scheduled server events can also appear alongside the automatic rotation.

---

## 📜 Banner History

Players can review previous pulls through the built-in History menu.

This makes it easier to track:

- Previous Pokémon obtained
- Pull rarity
- Recent gacha activity
- Progress toward future high-rarity pulls

---

## 🛠️ In-Game Editor Tools

One of the biggest additions in newer versions is the new **editor workflow**.

CobbleGacha Expanded now includes expanded tools for managing banners and Pokémon setups more conveniently in-game.

These tools make it much easier to configure the gacha system without constantly editing everything by hand.

**Editor improvements include:**

- Banner editing tools
- Banner creation tools
- Easier Pokémon setup workflows
- Cleaner management flow for server owners
- Better support for maintaining banner content across updates

---

## 🖼️ Banner Editor & Creator

Create and manage banners more easily with the improved banner editor workflow.

This is especially useful for servers that want to run recurring events, seasonal banners, themed rotations, or community-focused rate-up pools.

**Useful for:**

- Building new banner sets
- Adjusting featured Pokémon
- Preparing rotation order
- Managing themed events

---

## 🧬 Individual Pokémon Editor

CobbleGacha Expanded also includes support for more detailed Pokémon editing workflows.

This makes it easier to control how specific Pokémon rewards are configured for banners and events.

---

## 🎁 Improved Pull Result Cards

The pull result interface has been revamped compared to older versions.

Instead of relying on simpler reward presentation, Pokémon and item results are now shown in a larger and cleaner **card-style layout**.

**Pokémon cards can display:**

- Pokémon name
- Level
- Rarity
- IV spread

This makes pulls feel more satisfying and much easier to read.

---

## 🎟️ New Wish Item Visuals

The mod now includes an updated wish item presentation with improved visuals.

---

## 🖼️ Included Default Banner Pack

The mod includes a set of default generated banners so servers can get started faster.

These can be used as-is, expanded on, or replaced with custom server-themed banner sets.

## 🛠️ Server Banner Management

Administrators retain manual control over the automatic system.

Example commands include:

`/gachabanner start`  
`/gachabanner stop`  
`/gachabanner schedule`  
`/gachabanner reload`  
`/gachabanner list`

Manual and scheduled banners can coexist with the automatic rotation without corrupting the normal banner queue.

---

## 🎮 Open the Gacha Anywhere

Players can open the menu using:

`/gacha`

or

`/gachamenu`

---

## 🎨 Highly Configurable

Banner content is controlled through the server configuration.

Server owners can create their own:

- Legendary events
- Generation-themed banners
- Pokémon pools
- Rate-ups
- Event durations
- Banner names
- Artwork
- Rotation order

The included configuration contains a large selection of themed banners spanning multiple Pokémon generations.

---

## 🖥️ Compatibility

Designed for:

**Minecraft 1.21.1**  
**Cobblemon 1.7.3**

The mod is built as a **Fabric mod**.

It has also been developed and tested in a **NeoForge + Sinytra Connector** environment, although Connector compatibility should be considered secondary to the native Fabric environment.

---

## 📦 Installation

**Required**

- Cobblemon
- Fabric API
- Fabric Language Kotlin

### Client

Install the mod and required resource pack.

### Server

Install the mod and place the supplied configuration inside the server's `config` folder.

Both client and server should use matching compatible versions.

---

## ❤️ Credits

**CobbleGacha Expanded is a heavily expanded fork of Gacha and Server Utils by vinic.**

The original project provided the foundation upon which this version was developed.

This fork expands the original concept with systems including:

- Dynamic multi-banner support
- Configurable rate-ups
- 50/50 + guarantee mechanics
- Upcoming banner previews
- Pull history
- Improved pull animations
- Revamped pull result cards
- In-game editor tools
- Banner creation/editing workflows
- Better default presentation and bundled banner content
- Additional UI and compatibility improvements

Original inspiration / predecessor:  
[https://www.curseforge.com/minecraft/mc-mods/cobblemon-gacha-genshin-based](https://www.curseforge.com/minecraft/mc-mods/cobblemon-gacha-genshin-based)

The codebase and derivative work should be credited according to the license terms you choose to publish under.

---

## ⚠️ Disclaimer

CobbleGacha Expanded is an unofficial community project created for use with Cobblemon.

It is not affiliated with or endorsed by Mojang Studios, The Pokémon Company, Nintendo, GAME FREAK, or the Cobblemon development team.

Pokémon and related properties belong to their respective rights holders.