CreatureCapture

<p align="center"> <img src="https://media.forgecdn.net/attachments/356/127/cc_header.png" width="800" height="176" alt="CreatureCapture Header"> </p>

<p align="center"> <a href="https://discordapp.com/invite/jCsvJxS" rel="nofollow"> <img src="https://media.forgecdn.net/attachments/1574/957/discord-png.png" alt="Join Discord" width="212"> </a> <a href="https://github.com/apavarino/CreatureCapture"> <img src="https://media.forgecdn.net/attachments/355/455/get-it-on-github.png" width="207" height="80" alt="GitHub"> </a> <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=arthur.pavarino@gmail.com&currency_code=USD"> <img src="https://showertimer.world/wp-content/uploads/2020/12/paypal-donate-button.png" width="204" height="79" alt="Donate"> </a> </p>

<p align="center"><strong>Catch them all on your server</strong></p>

<p> CreatureCapture turns mob hunting into a real progression system. Use the <strong>Capture Bow</strong> to capture creatures, collect their spawn eggs, complete your personal collection, and compete with other players on the server leaderboard. </p>

<p> Perfect for survival servers, collection-based gameplay, custom progression, and for use alongside <a href="https://modrinth.com/plugin/spawnersilk">SpawnerSilk</a>. </p>

<h2>Features</h2>

<ul> <li><strong>Capture creatures with a special bow</strong> enchanted with Silk Touch</li> <li><strong>Collection system</strong>: every unique creature you capture is permanently recorded</li> <li><strong>Player progression</strong>: track your completion with <strong>/cc collection</strong> and <strong>/cc stats</strong></li> <li><strong>Competitive leaderboard</strong>: compare players with <strong>/cc top</strong></li> <li><strong>Persistent data storage</strong> with SQLite</li> <li><strong>Automatic migration</strong> from the old <em>captures.yml</em> format</li> <li><strong>Configurable mob list</strong>: enable or disable capture per creature in <strong>config.yml</strong></li> <li><strong>Configurable bow durability</strong> and <strong>capture chance</strong></li> <li><strong>Spawner interaction support</strong> and special Iron Golem egg handling</li> <li><strong>Tab completion</strong> for commands</li> </ul>

<h2>How it works</h2>

<ul> <li>Get a <strong>Capture Bow</strong> with <strong>/cc get</strong> or through the enchantment table</li> <li>Shoot a compatible creature with the bow</li> <li>If the capture succeeds, the creature is turned into its spawn egg</li> <li>The capture is added to the player’s permanent collection</li> </ul>

<p> This makes CreatureCapture more than a utility plugin: it adds a real <strong>collection and progression loop</strong> to your server. </p>

<h2>Commands</h2>

<table> <thead> <tr> <th>Command</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>/cc get</td> <td>Get a Capture Bow</td> </tr> <tr> <td>/cc reload</td> <td>Reload the plugin configuration</td> </tr> <tr> <td>/cc collection</td> <td>Show your captured creatures and progression</td> </tr> <tr> <td>/cc stats</td> <td>Show your personal capture stats</td> </tr> <tr> <td>/cc top</td> <td>Show the server leaderboard</td> </tr> </tbody> </table>

<h2>Permissions</h2>

<table> <thead> <tr> <th>Permission</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>creaturecapture.capture</td> <td>Allows players to capture creatures</td> </tr> <tr> <td>creaturecapture.cc</td> <td>Grants access to CreatureCapture commands</td> </tr> <tr> <td>creaturecapture.get</td> <td>Allows use of /cc get</td> </tr> <tr> <td>creaturecapture.reload</td> <td>Allows use of /cc reload</td> </tr> <tr> <td>creaturecapture.collection</td> <td>Allows use of /cc collection</td> </tr> <tr> <td>creaturecapture.stats</td> <td>Allows use of /cc stats</td> </tr> <tr> <td>creaturecapture.top</td> <td>Allows use of /cc top</td> </tr> </tbody> </table>

<h2>Compatibility</h2>

<p> Compatible with <strong>Bukkit, Spigot and Paper</strong>.<br> Built for modern Minecraft servers with <strong>1.13+ API support</strong> and updated against <strong>1.21.1</strong>. </p>

<h2>Configuration</h2>

<p>You can fully customize the plugin in <strong>config.yml</strong>:</p>

<ul> <li>Chance to get the Capture Bow in the enchantment table</li> <li>Bow durability</li> <li>Capture success chance</li> <li>Whether spawners can be modified with eggs</li> <li>Which creatures can or cannot be captured</li> </ul>

<hr>

<h2>Installation</h2>

<p> Drop <em>CreatureCapture.jar</em> into your <em>plugins</em> folder and restart your server. </p>

<h2>Issues & Support</h2>

<p> Found a bug or have a suggestion? Please report it in the <a href="https://github.com/Stellionix/CreatureCapture/issues">issue tracker</a> or join the Discord server. </p>