Description

Bettacraft
Realistic fishkeeping for Minecraft 1.21.1, 1.21.11, 26.1.2, 26.2 and 26.3, on NeoForge and Fabric. Catch wild fish and tankmates, keep them in multiblock aquariums of any shape, aquascape with swaying plants and corals, and breed with real genetics.


Bettas and genetics
- Wild bettas live in swamps (also those of biome mods). Catch them with a water bucket or a fish bag; the fish keeps all its genes. A magnifier, or the aquarium, reveals the hidden genes of a new animal. Some are the wild species Betta imbellis and Betta smaragdina, which cross with B. splendens into fertile hybrids.
- Mendel genetics: nine loci with dominance, carriers and mutations: 8 tail shapes, short and long fins, dumbo ears, 43 colours, 12 patterns and 16 named varieties (Koi Galaxy, Nemo, Black Orchid, Mustard Gas, Samurai, Hellboy ...). Colours, genes and varieties are data-driven and can be changed with datapacks.
- Breeding: condition the pair with live food, give them floating plants for the bubble nest, and raise eggs, larvae and fry through six life stages on infusoria and artemia that you culture yourself. Two adult males flare and fight, also at a mirror stick. The breeding tab shows Punnett squares.
- Aquarist villager: place a breeding basin in a village and an unemployed villager becomes an aquarist. He sells food, plants, shrimp, snails, test kits and live food cultures, as a master pairs of rare bred tankmates, and buys your bettas and bred tankmates by the rarity of their visible genes.
- Two sizes: Normal (the default, close to a real betta next to a block) or Large, one server setting for everyone; only the look and the hitbox change.


Tanks and the interior
- Multiblock tanks of any glass and any connected shape (box, L, T, steps ...), up to 16x16x16 (configurable up to 64; big tanks up to 32x16x32), with the connected texture of the glass or perfectly clear. Real vanilla water, filled bucket by bucket, and the animals are real entities.
- The interior: sneak and right-click with an empty hand to step inside the tank, a pocket dimension at 16 blocks per tank block. Build with any block: substrates, equipment and 29 decorations: castles, shipwrecks and a ship's bow, aquascaping stones (Seiryu, dragon stone, holey rock, lava rock, slate caves), roots, spiderwood, mangrove stilt roots, clay tubes that plecos breed in, a diving helmet and a treasure chest that bubbles from the air pump. Outside, the aquarium shows the result as a live miniature, and several players can build at once.
- Care: temperature from biome and time of day, heaters and coolers, hunger, stocking, water quality, oxygen, sickness and recovery. A tank menu with tabs (overview, inhabitants and their genes, breeding, water, devices, plants, interior, log), name sign, owner lock and break protection.

Plants and corals
- 49 aquarium plants (Java fern, Anubias, Bucephalandras that turn white or pink in strong light, mosses, Riccia, Cryptocorynes, sword plants, Rotala, Ludwigia and other stem plants, carpets such as Monte Carlo, HC 'Cuba' and hairgrass, Vallisneria, Aponogeton, tiger lotus ...) grow from a cutting into plants of many blocks, turn red in strong light, some need CO2 or soft water, are trimmed with shears and clean the water. The Marimo ball rolls with the current. Floating plants (duckweed, salvinia, water lettuce, hornwort ...) drift on the surface and spread.
- Liquid fertilizer from the fertilizer maker makes them grow faster; too much feeds the algae.
- Plants of Minecraft and other mods work too: kelp, seagrass, corals and the water plants of other mods lower the nitrate and count for breeding, without growing or needs.
- Every plant grows wild in the waters it comes from (jungle, swamp, river, mangrove, cold lakes, lush caves): shears cut a cutting, floating plants lie on calm water like lily pads.
- Every plant and coral has real leaves, polyps and tentacles that sway in the water, inside and in the miniature; zoanthids and star polyps close when a fish swims by.

Shrimp, snails and other small animals
- Neocaridina in eleven colours with selection grades that you breed up, bee shrimp from Crystal Red S to SSS, Sulawesi shrimp and snails, dwarf crayfish, nerites, apple snails and ramshorns. Algae grow, and the cleaning crew eats them.
- Dwarf clawed frogs breed like in nature: a cool water change sets a pair off, the spawn floats at the surface (fish eat it, floating plants hide it), and the tadpoles need infusoria before they become froglets.
- Big crayfish (blue and orange Florida crayfish, the all-female marbled crayfish) eat plants and catch slow fish.
- Axolotls get real care in a cool tank: eggs on the plants, larvae, and the five colours inherited by Mendel.

Tankmates
- 50 freshwater tankmates with their own models and behaviour: tetras (also gold, albino and diamond neons), rasboras and danios, rainbowfish, corydoras (albino and longfin pandas, the bronze cory), plecos, loaches and garras, barbs, guppies and endlers (with their own genetics and 28 strains), platys, mollies, swordtails, gouramis, cichlids (rams in six forms with Black and German Blue, Apistogramma, angelfish, discus) and puffers that eat snails.
- Shoals, water ranges, predators and prey, fin nippers, and a breeding style for every species: open and cave brooders guard their young.
- Water animals of other mods live in the aquariums too; whales, bosses and hostile mobs are refused with a reason.

Salt water, reef tanks and seahorses
- Sea water and salinity, protein skimmer, flow pump, live rock and actinic light. Seven corals and the bubble tip anemone grow with light, flow, calcium, alkalinity and magnesium from a four-channel dosing pump, and they bleach, glow and give frags. Clownfish spawn at their anemone and their larvae need rotifers (cultured on phytoplankton); the Banggai cardinalfish broods in the male's mouth, the mandarinfish lives on the copepods of the live rock; tangs, gobies, chromis, damsels, anthias, cleaner and fire shrimp, hermit crabs.
- A sump in the cabinet adds its water to the tank and holds heaters, a skimmer, filter media and a refugium with Chaetomorpha; a calcium reactor dissolves coral rubble with CO2 for the stony corals.
- Brackish water: the archerfish shoots insects off the leaves above the tank, the mudskipper lives on the mud of a paludarium, Amano larvae grow up in brackish water, and a mangrove propagule grows into a small mangrove over the water.
- Seahorses swim upright, hold on to plants and corals, and the male gives birth from his brood pouch.
- Big tanks up to 32 x 16 x 32 blocks with a size rule for big animals by their real length: the bamboo shark that lays egg cases, the blacktip reef shark, eagle and cownose rays, the honeycomb moray, and in fresh water pangasius, redtail and wels catfish, the arapaima and the motoro stingray. Vanilla dolphins live in very big sea water tanks. Catch the giants with the large net or a steel leader on your fishing rod into a transport tub.


Terraria and paludaria
- A tank without water is a terrarium, one with water and land a paludarium, with air temperature, humidity and UV from heat mats, basking lamps and misters. Fix the tank type in the menu and a terrarium is never flooded by mistake.
- Turtles (musk turtle, sliders, Hermann's tortoise, Reeves' turtle) lay eggs in the sand, and the nest temperature decides whether males or females hatch. Poison dart frogs with tadpoles, a horned frog that sits buried, geckos that climb the glass and a corn snake; grown sea turtles go into big sea water paludaria with a beach.
- Land animals of other mods (insects, small mammals, birds and reptiles of Naturalist, Critters and Companions and Living Things) live in terraria with our care and breeding; catch them with the terrarium box.
- Minecraft animals as pets: chickens with chicks from eggs in the sand, rabbits on grass, bees with flowers and a mini beehive, frogs, cats, foxes and more at their real size, walking with real steps. No drops, no farm.
- Mobs in glass: drowned, zombies, skeletons, spiders and small slimes live shrunk and harmless in a tank. Catch one in a mob jar or lure it in with bait: decoration, not a farm.


Technology
- Equipment: internal, external, sponge and corner filters, cabinets of any wood or stone (a row of cabinets gets one front with drawers and double doors), automatic and clip-on feeders, air pumps with air stones, light bars and LED panels in 16 colours with dimmer and daylight timer.
- Pipes and the multiblock filter: glass and stainless steel pipes and pumps carry water with all its values. A multiblock filter of any size with media that clog serves several aquariums: filter pipes with T-pieces dock on any side of a tank, up to four lines run in one pipe bundle, fresh and waste water ports change the water of every tank of the filter, and a pipe cover hides the pipes behind any block. A top-off and a water change controller keep the water for you.
- Water chemistry: TDS, pH and hardness from the water, the substrate, driftwood, leaves and CO2, with a range for every animal. CO2 cylinders and bio CO2, a reverse osmosis unit, and nitrate that makes water changes matter.
- Food: live food cultures (tubifex, daphnia, mosquito larvae, artemia) that a live food pump sends through the pipes; a food maker for pellets, flakes, wafers and frozen food. Every eater has favourite and poorly suited food: a varied diet helps the fish recover and makes the bettas' colours stronger.
- Monitors: monitor blocks join into screens of up to 8 x 5 blocks that find the tanks around them and show values, traffic lights, graphs, animals, devices and the logbook, with alarms that give a redstone signal.
- Power, your choice: by default nothing needs energy. With the power options on, the devices take Forge Energy (on Fabric Team Reborn Energy), or you wind them with a crank, or with Create a drive adapter runs every device of a tank on rotation with real stress.

A hired aquarist
Keep a few tanks and breed something, and an aquarist comes by to offer his work. Hire him, give him a bed and a breeding basin with a chest next to it, and he walks to your tanks every day: he feeds from the chest, changes the water from the reservoir, scrapes the algae, trims the plants, moves the young into a rearing tank and tells you what is wrong, for an emerald (or some bread) a day. Each of his six tasks has its own level in his menu. In multiplayer every player has his own, and he only works at his employer's tanks, those of the team (FTB Teams) and those released for him.
Handbook and menus
An in-game handbook in English and German with a page for every animal, plant, coral and device and where to get it (GuideME on NeoForge; on Fabric a Patchouli book on 1.21.1 and a Modonomicon book on 1.21.11 and 26.x, made from the same pages), 70 advancements, information pages in JEI (and REI and EMI on Fabric) and tooltips. Without a handbook mod every item explains itself in its tooltip.

Versions and loaders
One file per loader and Minecraft version, bettacraft-<loader>-<minecraft>-<version>.jar; install it on client and
server. Every version has the same content, ids, configs and handbook. On NeoForge no other mod is required; Fabric needs
Fabric API and Forge Config API Port (Mod Menu shows the config screen).
| Minecraft | Java | NeoForge | Fabric | Handbook on Fabric |
|---|---|---|---|---|
| 1.21.1 | 21 | 21.1.200+ | Loader 0.16+ | Patchouli |
| 1.21.11 | 21 | 21.11.40+ | Loader 0.17+, Fabric API 0.141+ | Modonomicon |
| 26.1.2 (Fabric also 26.1, 26.1.1) | 25 | 26.1.2.100+ | Loader 0.18.4+, Fabric API 0.155+ | Modonomicon |
| 26.2 | 25 | 26.2.0.95+ | Loader 0.18.4+, Fabric API 0.161+ | Modonomicon |
| 26.3 | 25 | 26.3.0.113+ | Loader 0.18.4+, Fabric API 0.166+ | Modonomicon |
Compatibility
The integrations below are those of 1.21.1. Each one works where the other mod exists for that loader and Minecraft version; what is missing where is listed after them.
- Handbook and info: GuideME, Patchouli or Modonomicon (handbook), JEI, REI and EMI (information pages, crucible and food maker recipes), Jade, The One Probe and WTHIT (aquarium, betta, filter, cabinet and aquarist lines).
- Aquarium and animal mods: Better Fish Tanks, Fintastic, Fish of Thieves, Aquaculture 2, Naturalist, Critters and Companions and Living Things: their animals get our care and breeding (their young inherit their colours), the giants go into big tanks by their real length, their land animals into terraria; deep-sea, giant and hostile animals are refused with a reason; modpacks add profiles for any animal.
- Tech mods: Mekanism, EnderIO, Create and Thermal make stainless steel; their tanks and pipes connect to Bettacraft pipes, aquariums and reservoirs (also AE2 and Refined Storage interfaces; on Fabric through the transfer API and Team Reborn Energy); CO2 gas of other mods fills CO2 cylinders. The facades of AE2, EnderIO, Mekanism Covers and Cable Facades hide the filter pipes.
- Create and Create Aeronautics: aquariums travel on contraptions, trains and airships with their animals, cared for on the road (on airships the fish swim on live) and with sloshing water; rotation drives pumps, the reverse osmosis unit, the food maker and the fertilizer maker, and the drive adapter powers a whole tank; Display Links show tank values. AE2 and Refined Storage autocrafting feeds the food maker and the crucible.
- For modpacks: an FTB Quests chapter "Bettacraft" (112 quests, English and German; quests of switched-off features
hide themselves), KubeJS events (animal born, animal died, monitor alarm), JourneyMap waypoints at tanks with a monitor
alarm, FTB Teams for the hired aquarist, and
/bettacraft foreign listto see which animals of other mods still need a profile. - Biome mods: the swamps, rivers, mangroves and warm oceans of Regions Unexplored, Oh The Biomes We've Gone, Biomes O' Plenty and others get the wild animals, plants and corals (biome tags).
- Sodium and Iris: supported, water and miniatures render correctly with shaders.
What is missing where (the other mod has no version there):
- Fabric, every version: Create and Create Aeronautics, AE2, KubeJS, Aquaculture, Fintastic and Cable Facades are NeoForge only; Mekanism, EnderIO and Thermal have no Fabric version (Fabric tech mods connect through the transfer API). A glowing pipe cover gives no light on Fabric. REI and EMI pages are Fabric only.
- 1.21.11: no Create, AE2, Refined Storage, KubeJS, Mekanism and the other power mods, Cable Facades, Better Fish Tanks, Fintastic, Naturalist, Critters and Companions, Regions Unexplored, Twilight Forest or EMI; The One Probe on NeoForge only.
- 26.1.2: no Create, Mekanism (and Covers), Industrial Foregoing, Farmer's Delight, Fintastic, Naturalist, Critters and Companions, Alex's Caves, Oh The Biomes We've Gone, EMI and a few more; AE2, KubeJS, Aquaculture and Cable Facades on NeoForge only.
- 26.2: no FTB Quests (so no quest chapter), KubeJS, Create, Mekanism, EnderIO, Industrial Foregoing, Refined Storage, Cable Facades, Fintastic, Critters and Companions, Regions Unexplored, Oh The Biomes We've Gone, Twilight Forest, Alex's Caves, EMI and a few more; AE2 and Aquaculture on NeoForge only. Naturalist and Better Fish Tanks work on both loaders.
- 26.3: as on 26.2, and no Modular Routers. Tanks and miniatures also draw correctly with the Vulkan backend. Shaders work with Iris on Fabric; on NeoForge 26.3 there is no working Sodium and Iris yet.



FAQ
Does it work with shaders? Yes. Sodium and Iris are supported, the water and the miniatures render correctly (on NeoForge 26.3 as soon as Sodium and Iris run there). The last three pictures under Compatibility were taken with Complementary Reimagined; every other picture on this page is without shaders.
Which Minecraft versions and loaders? 1.21.1, 1.21.11, 26.1.2 (on Fabric also 26.1 and 26.1.1), 26.2 and 26.3, each on NeoForge and Fabric, see Versions and loaders. Every version gets every new feature and fix. A world stays on its Minecraft version: within one Minecraft version it is migrated between Bettacraft versions, but it does not move to another Minecraft version.
Can I use it in my modpack? Yes. The mod is MIT licensed (code and all assets), so you may include it in any pack. Tags and datapacks control spawns, food, inhabitants and genetics, and the pack files (quest chapter, KubeJS example) come with every release.
Can I turn features off? Yes. Every feature has its own switch (features.* in config/bettacraft-common.toml, 136
in all): off, it loses its recipes, trades, loot and spawns, hides from the creative tab, JEI and the handbook, and its
logic rests. Presets (preset = SIMPLE | REALISTIC | DECOR) set other defaults in one line, care.mode = NO_DEATH keeps
every animal alive, and datapacks can use the bettacraft:feature recipe and loot condition.
Where is the config? serverconfig/bettacraft-server.toml in the world (tank size, animals, breeding, water, power,
the aquarist ...; on NeoForge 26.3 config/bettacraft-server.toml for every world, a world's own copy in its
syncedconfig/ folder), config/bettacraft-common.toml (spawns, feature switches) and config/bettacraft-client.toml
(render distances, connected glass, effects). The files and keys are the same on every loader and version. Every option
can also be changed in game: Mods > Bettacraft > Config (on Fabric through Mod Menu).
Do I need power? No. By default no device needs energy; with the power options on they take Forge Energy (Team Reborn Energy on Fabric), a crank or Create rotation.
Will my fish die while I am away? By default time stands still for aquariums in unloaded chunks, and water quality and evaporation are on but gentle.
Is it a beta? Yes. Worlds are migrated between versions and nothing should get lost, but keep backups. Bugs and ideas go to the issue tracker.
Acknowledgements
- Code, procedural textures, models, sounds and the logo: 0verEngineer. Every asset comes from the mod's own generator
(
tools/assetgen), no third-party assets are used. Licence: MIT. - AI disclosure: developed with the help of AI coding tools. No image or sound comes from an AI generator; the pictures and animations on this page are real in-game captures of the mod, taken automatically in its showcase world.
- Inspired by real betta and aquarium keeping. Thanks to the authors of NeoForge, Fabric, GuideME, Patchouli, Modonomicon, JEI, REI, EMI, Jade, Sodium, Iris, Complementary Reimagined and the mods Bettacraft works with.
- Source code, changelog and issues: github.com/0verEngineer/BettaCraft.




