🔭 The Scanner

Hold right click and look through the glass, like a spyglass. Your held item disappears while you look: you are looking through it.

• Reaches 15 blocks. It does not read through walls.
• How long a scan takes depends on distance: 2.5s within 5 blocks, 3.5 within 10, 4.5 within 15. Range is a choice, not a free upgrade.
• It ignores paintings, item frames, armour stands, minecarts, boats, End crystals and dropped items, and reads whatever is behind them.
• Crafted from iron, redstone, a diamond and an echolocation organ. With The Ravenous installed it wants a Screecher's organ; without it, an echo shard. You do not have to pick, the right recipe turns itself on.

🐾 What It Reads Out Of The Box

• Any creature, vanilla or modded: name, health, speed, jump height, armour, attack damage, whether it is peaceful, neutral or hostile and if a neutral one is angry right now. Time left before a baby grows up. Breeding cooldown. Whether it can be saddled or carry chests. Its owner. Its variant, down to which two genes a panda has.
• Plants and living blocks: growth stage, the light on the spot, whether that light is enough to grow, and roughly how long a growth attempt takes. 174 blocks, including leaves, grass blocks, mycelium, moss, coral (alive or dead), sculk, bee nests, turtle eggs, sniffer eggs, frogspawn, amethyst, bamboo, kelp and mushrooms.

🧠 It Remembers

The first pig takes as long as it always did. Every pig after that reads in a third of the time.

The wait is there to make range a real decision the first time you meet something, not to make you sit through it again for the thousandth pig. A third keeps the gesture and drops the queue. It remembers species, not individuals, and the record survives your death.

🌱 The Evolution Branch

If what you are looking at turns into something else, the whole line appears across the top of the screen when the scan lands: figure, arrow, figure.

Above any step there can be a tick, a cross, or nothing for creatures you have to raise, so you can see at a glance how it is going. A stage you fed, a stage you missed, a stage whose turn has not come.

The figures belong to whoever owns the creatures, so every mod brings its own.

⚙️ Commands

/bioscanner speed <n> — multiplies how long a scan takes. 1 is stock, 0.5 halves the waits, 0 reads instantly. Permission level 2.

🧩 For Modpack Makers: One JSON File

Drop it in data/<your namespace>/bioscanner/schede/<name>.json:

{
  "bersaglio": "minecraft:pig",
  "righe": [
    "A pig. It has no idea what is coming.",
    { "etichetta": "Health", "valore": "vita" }
  ]
}

• Works on entities and on blocks.
• Seven values you can ask for, and they read out loud: health, max health, speed, armour, damage, jump, name. The list is closed on purpose, an open NBT path would be more powerful and unusable, because you would have to know what the fields inside a creature are called, and that is written nowhere.
• A value that cannot be read on that target skips its line and leaves the others. A card written for a mob with no armour must not make its health disappear too.
• A card with a typo does not stop the others from loading, it goes in the log with the file name.
• /reload is enough. The cards reach the client on their own, so this works on a dedicated server.

🛠️ For Mod Makers: Readers

When what there is to say has to be calculated, a countdown, a state that changes, a file is not enough. Register a reader from your mod constructor and answer only for what is yours.

• Returning an empty list means "not mine", and you have to. Every reader sees everything the player looks at, and almost none of it concerns them. Answer anyway and you take the turn from everyone below you.
• Priorities: mods speak first, then datapack cards, then the built-in readers last. A description written on purpose never ends up underneath the generic one.
• You can declare an evolution branch too, and register your own sprites for it.

Both extension points are written out in full: fields, priorities, the complete list of values, working examples, in the full changelog, linked below.

ℹ️ Good To Know

• Needed on both client and server: the data lives on the server, the screen is drawn on the client.
• The Ravenous 3.0 and up requires this mod. If you play The Ravenous, install both.
• Coming from The Ravenous 3.0 before the split? Your scanners are safe. The item changed name, and Minecraft would normally delete the old one on world load, the mod tells the game they are the same thing.

🥚 And there is something inside it, for whoever finds it.

Read the full Changelog: https://drive.google.com/file/d/19Cp57RDkl9zFla7h9uN6B2bl5P7m26_0/view?usp=sharing

Changes:
Fix:
- The game would not open in some situations

Changes:
Technical:
- Added the ability to read when the viewfinder is not touching anything
- Added the ability to have a warning when a reading is finished