Skip to content
SwoftLang

Fishing ​

SwoftLang ships a complete fishing engine. A player right-clicks a fishing rod, a bobber flies out and settles on the water (or lava), a bite lands inside a configurable window, and reeling at the right moment pulls in a catch — an item that flies to the player, or a mob that spawns at the hook. What each rod pulls up is driven by declarative loot tables, and the whole lifecycle is exposed through four Player receiver methods.

swoftlang
fishing_loot "overworld_water" {
    medium: water
    catch item "COD" weight 40
    catch item "SALMON" weight 25
    catch item "PUFFERFISH" weight 10 message "<yellow>Careful, it puffs!"
}

Loot tables ​

A fishing_loot "<name>" { } block declares a weighted catch table. Each catch line adds one possible result; when a bite is landed against this table the engine picks one line at random, weighted by weight.

FieldMeaning
medium:which fluid this table fishes — water or lava
world:(optional) restrict the table to one world by name
catch item "<id>" weight <n>an item result — a vanilla material or a declared custom item
catch mob "<id>" weight <n>a mob result — spawns a declared custom mob at the hook
... message "<text>"(optional) a MiniMessage line sent to the fisher on that catch

Item ids resolve against your declared items first, then vanilla materials; mob ids must name a declared mob. An unknown id is a compile error, and the medium: enum is closed:

swoftlang
fishing_loot "ow" {
    medium: acid
    catch item "COD" weight 40
}
txt
med.sw:2:13: error: unknown fishing medium 'acid'; valid mediums: water, lava
    medium: acid
            ^

Table matching ​

Tables are matched by medium plus optional world. The most specific table wins — a table with a matching world: beats a medium-only table — and a built-in vanilla water table serves any bite that no declared table claims. Declaring a table for water in "world" and a broad lava table anywhere is enough to cover both fluids:

swoftlang
fishing_loot "overworld_water" {
    medium: water
    world: "world"
    catch item "COD" weight 40
    catch item "SALMON" weight 25
    catch item "PUFFERFISH" weight 10 message "<yellow>Careful, it puffs!"
}

fishing_loot "any_lava" {
    medium: lava
    catch item "MAGMA_CREAM" weight 8
    catch item "BLAZE_ROD" weight 2 message "<gold>Still warm."
}

The bite window ​

The delay between casting and a bite is configured in the server block, under a fishing { } section. min_bite and max_bite are duration literals; each cast rolls a bite time uniformly in that range.

swoftlang
server {
    motd: "Gone fishin'"
    fishing {
        min_bite: 4 seconds
        max_bite: 20 seconds
    }
}

With no fishing { } section, the engine uses its default window. Reel in before the bite and nothing happens; reel during the bite window and the catch is resolved.

The fishing methods ​

Four methods on the Player receiver cover the lifecycle. player is the angler, and each fires at the matching moment of the cast/bite/catch/reel cycle.

MethodFires
on_cast_rodbefore the bobber spawns
on_fish_bitewhen the bobber dips
on_catch_fishjust before the catch is delivered
on_reel_inwhen the line comes back in

on_cast_rod is the moment to greet or notify the angler as the line goes out:

swoftlang
Player {
    on_cast_rod {
        if player.world.time > 100000 {
            send "<gray>The fish are asleep." to player
        }
    }
}

on_catch_fish fires as the catch emerges — the loot itself is decided by the fishing_loot tables:

swoftlang
Player {
    on_catch_fish {
        send "<green>You landed something!" to player
    }
}

A complete custom fishing setup ​

Declared custom item and mob, two loot tables, a bite window, and handlers for the whole lifecycle — the entire feature in one file:

swoftlang
item "glimmering_cod" {
    material: "COD"
    name: "<aqua>Glimmering Cod"
    rarity: rare
    lore {
        line "<gray>It hums faintly."
    }
}

mob "sea_walker" {
    type: "ZOMBIE"
    name: "<dark_aqua>Sea Walker"
    health: 40
    ai: melee
}

fishing_loot "overworld_water" {
    medium: water
    world: "world"
    catch item "COD" weight 40
    catch item "SALMON" weight 25
    catch item "glimmering_cod" weight 5 message "<aqua>It glimmers in your hands."
    catch mob "sea_walker" weight 3 message "<red>Something walked out of the water..."
    catch item "PUFFERFISH" weight 10 message "<yellow>Careful, it puffs!"
}

fishing_loot "any_lava" {
    medium: lava
    catch item "MAGMA_CREAM" weight 8
    catch item "BLAZE_ROD" weight 2 message "<gold>Still warm."
}

server {
    fishing {
        min_bite: 4 seconds
        max_bite: 20 seconds
    }
}

Player {
    on_cast_rod {
        if player.world.time > 100000 {
            send "<gray>The fish are asleep." to player
        }
    }

    on_fish_bite {
        send "<aqua>Something's biting..." to player
    }

    on_catch_fish {
        send "<green>You landed something!" to player
    }

    on_reel_in {
        send "<gray>line reeled in" to player
    }
}

Custom-item catches carry their identity all the way into the player's inventory, and mob catches spawn as full custom mobs — aggro, drops, and all.