Big Salmon

# Big Salmon

Big Salmon is a mod that provides highly customizable salmon spawning sizes with support for custom loot table for big salmon. The default settings and included datapack provide parity with Minecraft: Bedrock Edition salmon sizes and salmon loot table.

## Features Salmon spawn with a weighted random size determined by the mod config. Adds the `Big:1b` NBT tag to salmon of size greater than or equal to the big salmon size threshold defined in the mod config. Adds the `Big:0b` NBT tag to salmon of size smaller than the aforementioned threshold. The default config provides parity with Minecraft: Bedrock Edition salmon sizes. The default salmon sizes and the sizes' probability weights are: Small salmon (size of 0. 35714) (0. 25 blocks wide) with a probability of 31. 5% (weight of 315). Medium salmon (size of 0. 71428) (0. 5 blocks wide) with a probability of 52. 6% (weight of 526). Big salmon (size of 1. 07142) (0. 75 blocks wide) with a probability of 15. 7% (weight of 157). The included datapack provides parity with Minecraft: Bedrock Edition salmon loot table. Salmon have a 25% chance of dropping bones. Small and medium salmon drop at most 1 bone. Big salmon drop at most 2 bones. Salmon do not drop bonemeal. Salmon retain their sizes when picked up with a water bucket and when placed down with a bucket of salmon Mod config may be modified in realtime using the config GUI (requires Mod Menu). Server mod config may be modified by clients who meet permission requirements set in the server mod config. This mod may be run solely on the server (client-side installation of this mod is not required on servers with this mod installed).

## Supported Platforms Big Salmon is currently available for Fabric on Minecraft: Java Edition version 1. 21 to 1. 21. 1.

# Installation

#### Prerequisites JRE/JDK 21 Minecraft: Java Edition version 1. 21 to 1. 21. 1 (https://fabricmc.net/use/installer) (https://modrinth.com/mod/fabric-api/versions) (https://modrinth.com/mod/modmenu/versions) (optional)

#### Obtaining the Big Salmon mod file `.jar`

Download the Big Salmon mod file `.jar` from (https://modrinth.com/project/bigsalmon/versions).

#### Installing the Big Salmon mod file Once you have the Big Salmon mod file `.jar`, move it into the `mods` folder in your Fabric Loader installation folder.

For more information on installing Fabric mods, check out these (https://docs.fabricmc.net/players/).

## Configuration

### Config GUI (requires Mod Menu)

If the Mod Menu mod is installed, the config GUI may be accessed through `Main Menu or Game Menu > Mods > Big Salmon > Configure...`. If connected to a server (LAN or dedicated), permission to modify the config from the config GUI may be limited depending on the server config.

Changes are applied and saved to the config file immediately if the config is modified from the config GUI (the Minecraft client or server does not need to be restarted).

### Config file

The config file should be stored with the filename `bigsalmon.json` in the folder `config` in the Minecraft installation or server folder. To reload the config from the config file, the Minecraft client or server needs to be restarted.

If the config file is not present, the mod will revert to the default config.

#### Default config `bigsalmon.json` ```json { "enabled": false, "customizer_client": "op", "any_client_can_read_config": false, "big_salmon_size_threshold": 1. 07142, "size_weights": [ { "size": 0. 35714, "weight": 315 }, { "size": 0. 71428, "weight": 526 }, { "size": 1. 07142, "weight": 157 } ] } ```

#### Config members If any of these members (excluding `size_weight` elements) are missing, the mod will use the default value for that member.

`enabled` (`true` or `false`): whether the mod is enabled (salmon spawn with random sizes and are given their respective `Big:0b` or `Big:1b` NBT tags). `customizer_client` (`"none"`, `"op"`, or `"none"`): when the mod is running on a server (LAN or dedicated), whether anyone, only level 4 operators, or nobody respectively, may modify the config. `any_client_can_read_config` (`true` or `false`): when the mod is running on a server (LAN or dedicated), whether anyone may view the config regardless of if they have permission to do so according to `customizer_client`. `big_salmon_size_threshold` (`0. 0625` to `16. 0` (inclusive) and greater than or equal to one of the `size` values in `size_weights`): salmon of this size or greater are given the `Big:1b` NBT tag, otherwise they are given the `Big:0b` NBT tag. * `size_weights` (array of elements with members `size` (`0. 0625` to `16. 0`) and `weight` (at least `1`)): an array of salmon sizes (scalar value