Перейти к содержимому
Mineforgian

Cobbleloots: Loot Balls and More!

A side-mod for cobblemon that adds different ways to obtain items like in the original games.

1.6M загрузок232 подписчиковMITfabricneoforge

Обновлён 29 марта 2026 г. · опубликован 17 декабря 2023 г.

  • Loot Balls
  • Great Loot Ball under a tree - by Yuxo
  • Rainbow Loot Ball

Cobbleloots: Loot Balls and More!

Cobbleloots is a mod for Cobblemon that adds different ways to obtain items based on the original Pokémon video games.

IMPORTANT (BETA-2.2.0+): Recent updates have introduced breaking changes, especially with the configuration. You will need to update your configurations to ensure compatibility.

Features

Loot Balls 💎

These balls contain useful items for the player. They can grant XP and items when opened, and can be used as a decorative entity in survival mode. When a loot ball has no remaining uses, it can be destroyed to drop as a decorative item (this behavior is configurable).

Obtaining Loot Balls

  • Generation: Loot balls can be found in the world. Some of them are specific to biomes, while others are more common.
  • Spawning: Over time, loot balls will spawn in the world around random players.
  • Fishing: Players can catch loot balls when fishing with Cobblemon Poké Rods. Different rods can catch different tiers of loot balls, and using the Luck of the Sea enchantment increases the chance of finding a loot ball.

Loot balls are categorized into tiers that determine their rarity and loot quality: Common, Uncommon, Rare, and Ultra Rare.

Mapmaking 🗺️

Check out the documentation to learn how to use the mod objects and features in your custom maps. If you still have questions, feel free to ask on my discord server.

Note: The documentation is a work in progress, and some features may not be fully documented yet. If you need help with a specific feature, please reach out on my Discord server.

Custom Loot Balls 🎁

Create custom loot balls with different items and properties using the new Loot Ball Data system. You can customize various aspects, including:

  • The name displayed in-game.
  • The loot table used when opened.
  • The texture of the loot ball.
  • The amount of XP granted to the player.
  • Player-specific timers (cooldowns) before a player can reopen the loot ball.
  • Sources for how loot balls appear (e.g., generation, spawning), with detailed filters:
    • weight for rarity.
    • structure tags.
    • biome tags (biome keys, biome tags, or biome dicts).
    • dimension lists.
    • block tags (for spawn block or base block).
    • fluid tags.
    • position (x, y, z coordinates with min/max ranges).
    • light levels (block and sky, for spawning).
    • time of day (with period options).
    • date ranges (e.g., seasonal events).
    • weather conditions (clear, rain, thunder).
  • Variants for a single loot ball type, each with its own optional name, texture, and loot table.

Some of these features are continuously being refined, but the data system is designed for flexibility and future additions.

Mod configuration ⚙️

The mod configuration is powered by MidnightLib and supports in-game editing:

  • Fabric: Edit via ModMenu.
  • NeoForge: Edit via the Mods menu.
  • Command: Server OPs can use /midnightconfig cobbleloots <key> <value>.

The config file is located in the config folder of your Minecraft instance. Check the Configuration docs for more information.

FAQ

How do I make loot balls give loot to every player, not just the first one?

This is a common setup for servers where you want all players to be able to collect loot from the same ball.

You need two things:

  1. Infinite uses — Set the uses NBT tag on the loot ball to -1. A loot ball with -1 uses is infinite and works on a per-player basis: each player gets their own loot independently.
  2. Player cooldown (optional) — Set the PlayerTimer NBT tag to a number of ticks. This is the cooldown before a player can collect from the same ball again. If omitted (or set to 0), each player can only ever collect once.

To apply this globally to all new loot balls, update the default configuration values:

  • Set loot_ball_default_uses to -1 → all newly spawned/generated loot balls will have infinite uses.
  • Set loot_ball_default_player_cooldown to the desired cooldown in ticks (e.g., 72000 = 1 hour) → players can reclaim after that time. Set to 0 to allow each player to collect exactly once, with no reclaim.

See the Configuration docs for more details.

Planned Features

Commands 🛠️

Commands to help mapmakers and server owners to manage the mod features.

Hidden Items 🔍

Inspired by the original Pokémon games, Hidden Items are invisible objects scattered across the world, waiting to be discovered.

Fake Items 🪤

Be aware that some objects may not be what they appear to be. Pokémon will sometimes disguise themselves as objects in order to trick you.

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
2.3.0Бета1.21.1neoforge29 марта 2026 г..jar (264 КБ)
2.3.0Бета1.21.1fabric29 марта 2026 г..jar (261 КБ)
2.2.2Бета1.21.1neoforge23 февраля 2026 г..jar (235 КБ)
2.2.2Бета1.21.1fabric23 февраля 2026 г..jar (234 КБ)
2.2.1Бета1.21.1neoforge21 февраля 2026 г..jar (235 КБ)
2.2.1Бета1.21.1fabric21 февраля 2026 г..jar (234 КБ)
2.2.0Бета1.21.1neoforge21 февраля 2026 г..jar (244 КБ)
2.2.0Бета1.21.1fabric21 февраля 2026 г..jar (234 КБ)
2.1.0Альфа1.21.1neoforge26 ноября 2025 г..jar (157 КБ)
2.1.0Альфа1.21.1fabric26 ноября 2025 г..jar (154 КБ)
2.0.10Альфа1.21.1neoforge25 октября 2025 г..jar (157 КБ)
2.0.10Альфа1.21.1fabric25 октября 2025 г..jar (154 КБ)
2.0.9Альфа1.21.1fabric28 сентября 2025 г..jar (140 КБ)
2.0.9Альфа1.21.1neoforge28 сентября 2025 г..jar (143 КБ)
2.0.8Альфа1.21.1neoforge3 июля 2025 г..jar (142 КБ)

Показаны последние 15 из 43 версий. Все версии — на Modrinth.

Ченджлог

2.3.0Бета1.21.1 · 29 марта 2026 г.

Changes

  • In-Game Creative GUI: Added a creative-mode GUI for editing loot ball properties (Type, Variant, Uses, Cooldowns, etc.) directly in the game.
  • Documentation: Updated guide for using the Creative GUI under docs/guides/how-to/creative.md.
  • Structure Filter Enhancement: The structure field in the loot ball source filter now supports multiple input formats (string ID, object ID, or array of IDs).
  • Localization: Updated English (en_us), Brazilian Portuguese (pt_br) and Spanish (Ecuador) (es_ec) translations with new GUI strings. Spanish (Ecuador) contributed by wajo21x.

Technical Changes

  • Networking Overhaul: Implemented cross-platform (Fabric/NeoForge) networking for loot ball updates and custom packet payloads.
  • NeoForge Refactoring: Updated CobblelootsNeoForge to resolve @EventBusSubscriber deprecations and correctly register payload handlers using NeoForge's RegisterPayloadHandlersEvent.

Bug Fixes

  • Fixed structure filter not working with non-tag inputs.
  • Fixed biome filter not reading the required field.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.3.0Бета1.21.1 · 29 марта 2026 г.

Changes

  • In-Game Creative GUI: Added a creative-mode GUI for editing loot ball properties (Type, Variant, Uses, Cooldowns, etc.) directly in the game.
  • Documentation: Updated guide for using the Creative GUI under docs/guides/how-to/creative.md.
  • Structure Filter Enhancement: The structure field in the loot ball source filter now supports multiple input formats (string ID, object ID, or array of IDs).
  • Localization: Updated English (en_us), Brazilian Portuguese (pt_br) and Spanish (Ecuador) (es_ec) translations with new GUI strings. Spanish (Ecuador) contributed by wajo21x.

Technical Changes

  • Networking Overhaul: Implemented cross-platform (Fabric/NeoForge) networking for loot ball updates and custom packet payloads.
  • NeoForge Refactoring: Updated CobblelootsNeoForge to resolve @EventBusSubscriber deprecations and correctly register payload handlers using NeoForge's RegisterPayloadHandlersEvent.

Bug Fixes

  • Fixed structure filter not working with non-tag inputs.
  • Fixed biome filter not reading the required field.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.2.2Бета1.21.1 · 23 февраля 2026 г.

Bug Fixes

  • Fixed NeoForge dedicated server crash caused by client-only config screen registration (IConfigScreenFactory) being loaded on the server side.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.2.2Бета1.21.1 · 23 февраля 2026 г.

Bug Fixes

  • Fixed NeoForge dedicated server crash caused by client-only config screen registration (IConfigScreenFactory) being loaded on the server side.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.2.1Бета1.21.1 · 21 февраля 2026 г.

Bug Fixes

  • Fixed a NeoForge crash when another mod (e.g. Farming for Blockheads) also bundles MidnightLib, causing a split-package module resolution error.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.2.1Бета1.21.1 · 21 февраля 2026 г.

Bug Fixes

  • Fixed a NeoForge crash when another mod (e.g. Farming for Blockheads) also bundles MidnightLib, causing a split-package module resolution error.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.2.0Бета1.21.1 · 21 февраля 2026 г.

Gameplay Changes

  • Added Loot Ball Fishing:
    • Implemented fishing as a new loot ball source.
    • Players can now catch loot balls when fishing with Cobblemon Poké Rods.
    • Different rods can catch different tiers of loot balls (e.g. Master Rod is required for Master Loot Balls).
    • Using the Luck of the Sea enchantment increases the chance of finding a loot ball.
    • Added configurable despawn delay for fished loot balls.
    • Fished loot balls move towards the player (similar to items).
  • Loot Ball Balance Overhaul: All loot tables and loot ball definitions were reworked to be more balanced.
    • New tiers for loot balls were defined:
      • Common: More frequent, with simpler loot tables.
      • Uncommon: Less frequent, with more complex loot tables.
      • Rare: Rare, with more valuable loot tables.
      • Ultra Rare: Very rare, with the most valuable loot tables.
    • Ball variants from Poké Ball were split into standalone files.
    • Added 6 new loot balls; Lure, Dusk, Quick, Timer, Nest and Net.
    • Common Loot Balls:
      • Poké: Can now be found everywhere, spawns in all biomes and can be fished with any rod (or with a poké rod for higher chances).
      • (NEW) Azure: Can now be found from generation and spawning sources in oceans, coasts and rivers. It can be fished with any rod in those biomes (or with an azure rod for higher chances).
      • (NEW) Citrine: Can now be found from generation and spawning sources in deserts, badlands and savannas. It can be fished with any rod in those biomes (or with a citrine rod for higher chances).
      • (NEW) Verdant: Can now be found from generation and spawning sources in forests and plains. It can be fished with any rod in those biomes (or with a verdant rod for higher chances).
      • (NEW) Roseate: Can now be found from generation and spawning sources in floral and lush biomes. It can be fished with any rod in those biomes (or with a roseate rod for higher chances).
      • (NEW) Slate: Can now be found from generation and spawning sources in caves and volcanic biomes. It can be fished with any rod in those biomes (or with a slate rod for higher chances).
      • Premier: Can now be found from generation and spawning sources in mountains. It can be fished with any rod in those biomes (or with a premier rod for higher chances).
    • Uncommon Loot Balls:
      • Great: Can now be found everywhere, spawns in all biomes and can be fished with any rod (or with a great rod for higher chances).
      • Dive: Can now be found from generation and spawning sources in oceans and deep oceans. It can be fished with any rod in those biomes (or with a dive rod for higher chances).
      • Heal: Can now be found from generation and spawning sources everywhere in the overworld dimension. It can be fished with any rod in the overworld (or with a heal rod for higher chances).
      • Safari: Can now be found from generation and spawning sources in savanna biomes. It can be fished with any rod in those biomes (or with a safari rod for higher chances).
      • Pumpkin: Can now be found from generation and spawning sources in biomes defined in the pumpkin biome tag and in the nether dimension (It only spawns during night in the overworld biomes). It can be found only from october 1st to november 1st. It can be fished anywhere with any rod during the same date range.
      • Rainbow: Can now be found from generation and spawning sources in biomes defined in the rainbow biome tag. It only spawns during day with "direct" sunlight (sky light level 7 or higher). It can be fished with any rod in those biomes.
      • (NEW) Lure: Can be fished with any rod in deep ocean biomes (or with a lure rod for higher chances). It doesn't spawn naturally nor can be obtained from generation sources, as it is exclusively obtained from fishing.
      • (NEW) Nest: Can be found from generation and spawning sources in forests and swamps. It can be fished with any rod in those biomes (or with a nest rod for higher chances).
      • (NEW) Net: Can be found from generation and spawning sources in oceans, swamps and rivers. It can be fished with any rod in those biomes (or with a net rod for higher chances).
      • (NEW) Quick: Can be found from generation and spawning sources in plains and sky biomes, and in the end dimension. It can be fished (only in the overworld) with any rod in those biomes (or with a quick rod for higher chances).
      • (NEW) Timer: Can be found from generation and spawning sources in badlands biomes and in the nether dimension. It can be fished (only in the overworld) with any rod in those biomes (or with a timer rod for higher chances).
    • Rare Loot Balls:
      • Ultra: Can now be found everywhere, spawns in all biomes and can be fished with an ultra rod.
      • Luxury: Can now be found everywhere in the end dimension from generation and spawning sources. It can't be fished.
      • (NEW) Dusk: Can be found from generation sources in spooky and deep dark biomes. It can spawn in those biomes in dark places (low light level). It can be fished during night with any rod in those biomes (or with a dusk rod for higher chances).
    • Ultra Rare Loot Balls:
      • Master: Can now be found everywhere, spawns in all biomes and can be fished with a master rod.
  • Opening Effects: Added special effects when opening loot balls:
    • Display the received item floating above the loot ball.
    • Particle effects on open (customizable via config).

Technical Changes

  • Configuration Overhaul: All configurations options were refactored to use a new configuration system.
    • Implemented full in-game configuration support for Fabric via ModMenu and NeoForge via Mods menu.
    • Server OPs can now edit the configuration in-game using /midnightconfig cobbleloots <key> <value>.
    • On first launch with this version, old configuration values will be preserved and migrated to the new format.
      • The old cobbleloots.yaml file will be renamed to cobbleloots.yaml.old after successful migration.
    • Check the new Configuration docs for more information.
  • Localization:
    • Added full localization support for configuration keys (en_us.json).
    • Added translation keys for new messages.
    • Added Brazilian Portuguese (pt_br.json) translation. Initial base keys contributed by PrincessStelllar via PR #21.
  • Dependencies:
    • Switched internal configuration library to MidnightLib for better cross-platform support.
  • Updated Biome Filters: Biome filters now accept:
    • Biome keys: "minecraft:swamp"
    • Biome tags: "#cobblemon:is_swamp"
    • Biome dicts: {"id": "#c:is_ocean", "required": false}
    • Lists: Mix of any of the above
  • Updated Documentation: Updated the mod documentation.
    • New and updated pages for all loot balls, showing general information, loot table and obtaining methods.
    • Updated Reference page with updated biome tag information.
    • Added a new Configuration page with updated information about the configuration system.
    • Updated the mod guides and examples to reflect the new changes.

Bug Fixes

  • Fixed a bug where disabled loot balls were not being disabled after a /reload command and only after a server restart.
  • Fixed a bug where reloading loot balls with /reload would not refresh loot ball client data on existing entities.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

2.2.0Бета1.21.1 · 21 февраля 2026 г.

Gameplay Changes

  • Added Loot Ball Fishing:
    • Implemented fishing as a new loot ball source.
    • Players can now catch loot balls when fishing with Cobblemon Poké Rods.
    • Different rods can catch different tiers of loot balls (e.g. Master Rod is required for Master Loot Balls).
    • Using the Luck of the Sea enchantment increases the chance of finding a loot ball.
    • Added configurable despawn delay for fished loot balls.
    • Fished loot balls move towards the player (similar to items).
  • Loot Ball Balance Overhaul: All loot tables and loot ball definitions were reworked to be more balanced.
    • New tiers for loot balls were defined:
      • Common: More frequent, with simpler loot tables.
      • Uncommon: Less frequent, with more complex loot tables.
      • Rare: Rare, with more valuable loot tables.
      • Ultra Rare: Very rare, with the most valuable loot tables.
    • Ball variants from Poké Ball were split into standalone files.
    • Added 6 new loot balls; Lure, Dusk, Quick, Timer, Nest and Net.
    • Common Loot Balls:
      • Poké: Can now be found everywhere, spawns in all biomes and can be fished with any rod (or with a poké rod for higher chances).
      • (NEW) Azure: Can now be found from generation and spawning sources in oceans, coasts and rivers. It can be fished with any rod in those biomes (or with an azure rod for higher chances).
      • (NEW) Citrine: Can now be found from generation and spawning sources in deserts, badlands and savannas. It can be fished with any rod in those biomes (or with a citrine rod for higher chances).
      • (NEW) Verdant: Can now be found from generation and spawning sources in forests and plains. It can be fished with any rod in those biomes (or with a verdant rod for higher chances).
      • (NEW) Roseate: Can now be found from generation and spawning sources in floral and lush biomes. It can be fished with any rod in those biomes (or with a roseate rod for higher chances).
      • (NEW) Slate: Can now be found from generation and spawning sources in caves and volcanic biomes. It can be fished with any rod in those biomes (or with a slate rod for higher chances).
      • Premier: Can now be found from generation and spawning sources in mountains. It can be fished with any rod in those biomes (or with a premier rod for higher chances).
    • Uncommon Loot Balls:
      • Great: Can now be found everywhere, spawns in all biomes and can be fished with any rod (or with a great rod for higher chances).
      • Dive: Can now be found from generation and spawning sources in oceans and deep oceans. It can be fished with any rod in those biomes (or with a dive rod for higher chances).
      • Heal: Can now be found from generation and spawning sources everywhere in the overworld dimension. It can be fished with any rod in the overworld (or with a heal rod for higher chances).
      • Safari: Can now be found from generation and spawning sources in savanna biomes. It can be fished with any rod in those biomes (or with a safari rod for higher chances).
      • Pumpkin: Can now be found from generation and spawning sources in biomes defined in the pumpkin biome tag and in the nether dimension (It only spawns during night in the overworld biomes). It can be found only from october 1st to november 1st. It can be fished anywhere with any rod during the same date range.
      • Rainbow: Can now be found from generation and spawning sources in biomes defined in the rainbow biome tag. It only spawns during day with "direct" sunlight (sky light level 7 or higher). It can be fished with any rod in those biomes.
      • (NEW) Lure: Can be fished with any rod in deep ocean biomes (or with a lure rod for higher chances). It doesn't spawn naturally nor can be obtained from generation sources, as it is exclusively obtained from fishing.
      • (NEW) Nest: Can be found from generation and spawning sources in forests and swamps. It can be fished with any rod in those biomes (or with a nest rod for higher chances).
      • (NEW) Net: Can be found from generation and spawning sources in oceans, swamps and rivers. It can be fished with any rod in those biomes (or with a net rod for higher chances).
      • (NEW) Quick: Can be found from generation and spawning sources in plains and sky biomes, and in the end dimension. It can be fished (only in the overworld) with any rod in those biomes (or with a quick rod for higher chances).
      • (NEW) Timer: Can be found from generation and spawning sources in badlands biomes and in the nether dimension. It can be fished (only in the overworld) with any rod in those biomes (or with a timer rod for higher chances).
    • Rare Loot Balls:
      • Ultra: Can now be found everywhere, spawns in all biomes and can be fished with an ultra rod.
      • Luxury: Can now be found everywhere in the end dimension from generation and spawning sources. It can't be fished.
      • (NEW) Dusk: Can be found from generation sources in spooky and deep dark biomes. It can spawn in those biomes in dark places (low light level). It can be fished during night with any rod in those biomes (or with a dusk rod for higher chances).
    • Ultra Rare Loot Balls:
      • Master: Can now be found everywhere, spawns in all biomes and can be fished with a master rod.
  • Opening Effects: Added special effects when opening loot balls:
    • Display the received item floating above the loot ball.
    • Particle effects on open (customizable via config).

Technical Changes

  • Configuration Overhaul: All configurations options were refactored to use a new configuration system.
    • Implemented full in-game configuration support for Fabric via ModMenu and NeoForge via Mods menu.
    • Server OPs can now edit the configuration in-game using /midnightconfig cobbleloots <key> <value>.
    • On first launch with this version, old configuration values will be preserved and migrated to the new format.
      • The old cobbleloots.yaml file will be renamed to cobbleloots.yaml.old after successful migration.
    • Check the new Configuration docs for more information.
  • Localization:
    • Added full localization support for configuration keys (en_us.json).
    • Added translation keys for new messages.
    • Added Brazilian Portuguese (pt_br.json) translation. Initial base keys contributed by PrincessStelllar via PR #21.
  • Dependencies:
    • Switched internal configuration library to MidnightLib for better cross-platform support.
  • Updated Biome Filters: Biome filters now accept:
    • Biome keys: "minecraft:swamp"
    • Biome tags: "#cobblemon:is_swamp"
    • Biome dicts: {"id": "#c:is_ocean", "required": false}
    • Lists: Mix of any of the above
  • Updated Documentation: Updated the mod documentation.
    • New and updated pages for all loot balls, showing general information, loot table and obtaining methods.
    • Updated Reference page with updated biome tag information.
    • Added a new Configuration page with updated information about the configuration system.
    • Updated the mod guides and examples to reflect the new changes.

Bug Fixes

  • Fixed a bug where disabled loot balls were not being disabled after a /reload command and only after a server restart.
  • Fixed a bug where reloading loot balls with /reload would not refresh loot ball client data on existing entities.

Beta versions may contain bugs. Please report any issues you find on the Discord server.

Полная история изменений — на Modrinth.

Комментарии

Загружаем…