TrapCore+

# TrapCorePlus

A PaperMC plugin for Minecraft 1.21.1 that runs a clan-based trap PvP land system: operators
carve numbered trap regions out of the map chunk by chunk, clans buy them, defend a health pool,
pay a recurring tax, and lose the land the moment either runs out.

Player-facing text, config keys and commands are Turkish.

## Features

- **Clans** — ranks, a shared bank, per-rank permission grids for both clan management and trap
actions, an open/closed toggle and a friendly-fire switch.
- **Trap land** — chunk-carved regions (1 chunk on a flank plot, 3 on a corner), a health pool
that drains from PvP deaths and TNT blasts, a recurring tax that repossesses unpaid land, and
tiers that layer default price/tax/health/clan-level requirements over ranges of trap numbers.
- **Zones** — wand-selected cuboids with a priority and partial flag overrides (PvP, building,
explosions, ...), for spawn areas and anything else that needs a rule different from the trap
default.
- **Trap TNT** — a marked, thrown TNT item whose blast carves a temporary hole (blocks return
after a configurable delay) and drains the health of whichever traps it actually reached.
- **Custom enchantments** — server-only enchantments applied through an anvil-style upgrade menu,
independent of vanilla enchantment mechanics.
- **Converter economy** — a menu that prices items (flat or per-enchantment-level) and a Vault
hook for trap purchases, tax and reinforcement.
- **PlaceholderAPI** — clan and trap stats, plus a 5-second-cached leaderboard.
- **Admin tooling** — `/trapadmin menu` covers land (traps, tiers, zones), clans, and systems
(levels, economy, converter, TNT) with confirmation prompts on anything irreversible, plus a
per-session bypass toggle for support work.

## Commands

- `/klan` — clan menu and management (`/klan yardim` for the full command list)
- `/trap` — buying, selling, and managing owned trap land (`/trap yardim`)
- `/trapadmin` — operator tooling, gated behind `trapcoreplus.admin` and its per-branch nodes
- `/donustur`, `/yukselt` — the item converter and the custom-enchantment upgrade menu

## Requirements

- PaperMC 1.21.1 (Paper/Adventure APIs are used directly; it will not load on plain Spigot)
- Java 21
- [Vault]( https://github.com/MilkBowl/VaultAPI) — optional, needed for trap purchases/tax/reinforcement
- [PlaceholderAPI]( https://github.com/PlaceholderAPI/PlaceholderAPI) — optional, needed for placeholders

## Building locally

```bash
./gradlew build
```

This runs Checkstyle, SpotBugs, and the unit test suite alongside the compile. The shaded jar
lands in `build/libs/`.

```bash
./gradlew -Pver="v1.0.0" release
```

produces a version-tagged release build; see [docs/releases.md](docs/releases.md) for the full
versioning scheme.

## Documentation

- [docs/KILAVUZ.md](docs/KILAVUZ.md) — full Turkish setup and gameplay guide
- [docs/PLACEHOLDER-VE-IZINLER.md](docs/PLACEHOLDER-VE-IZINLER.md) — every placeholder and permission node
- [docs/usage.md](docs/usage.md) — extending the plugin (commands, config, menus, listeners)
- [docs/releases.md](docs/releases.md) — versioning and how to cut a release
- [docs/skills.md](docs/skills.md) — agent instructions and available skills

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

[GPL-3.0](LICENSE)