Sketchbook

Entity Studies

Sketchbook can turn a Spyglass into a field-study tool. Study a living entity first, then place that entity as a sketched subject on an empty book page.

Quick flow
  • Hold right click with a Spyglass while looking directly at a living entity.
  • The first study identifies the entity and stores its visual variant for your player.
  • Keep studying the same identified entity for the longer detailed pass.
  • Open a writable book, right click an empty page, choose Entities, then place a studied entity sketch.

Studying With A Spyglass

Entity study only runs while the client has no other screen open and the player is actively using a Spyglass.

RuleBehavior
Target typeThe target must be a living entity. Players are ignored.
RangeThe target can be up to 96 blocks away.
VisibilityThe target must be alive, visible, pickable, and in line of sight.
AimYour look ray must hit the target's inflated hitbox, so glancing near the entity is not enough.
FeedbackThe target glows while being studied, particles orbit it, and a progress bar appears near the crosshair.

The first pass takes about 3 seconds. If the entity is already identified but still missing details, Sketchbook starts the detailed pass instead.

Studying a Creeper in detail through a Spyglass

The screenshot above shows the second tier: Studying in great detail. The orange bar is the detailed-study progress bar, which takes 300 ticks instead of the shorter 60-tick identify pass. During the scan, Sketchbook makes the target glow and spawns orbiting particles around it. The regular identify pass uses enchant-style particles and a cyan bar; the detailed pass keeps those particles and adds witch-style particles with an orange bar so the longer scan is easy to tell apart.

Scan HUD Reference

Identify
60 ticks. Cyan bar. Enchant particles mark the target while its type and visual variant are learned.
Studying: Creeper
Detailed study
300 ticks. Orange bar. Witch particles join the enchant particles while combat and movement details are learned.
Studying in great detail: Creeper

Two Study Tiers

TierTimeUnlocks
Identify60 ticksThe entity type, display name, and visual variant can be used for entity sketches.
Detailed study300 ticksOptional page details for health, armor, movement speed, armor toughness, and attack damage.

Detailed study only starts after the same entity variant has already been identified. The server checks Spyglass use, range, line of sight, and aim again when the study completes, so moving away or losing sight cancels the result.

Variant data

Sketchbook stores only stable visual data such as cat/wolf variants, tropical fish variants, markings, and colour values. Position, health, equipment, AI state, passengers, UUIDs, and other volatile entity data are stripped out.

Entity Sketches In Books

After a target has been identified, it appears in the book page context menu under Entities.

  1. Open a Book and Quill, or a compatible Scholar book/lectern.
  2. Right click an empty page.
  3. Choose Entities.
  4. Select one of the studied entities.
  5. Toggle any unlocked detail lines you want shown on the page.

Entity sketches follow the same page rules as normal sketches: a new entity sketch needs an empty page and a usable Pencil or Pencil Case. Updating the visible detail lines on an existing entity sketch also requires a pencil. A normal screenshot sketch and an entity sketch cannot occupy the same page.

Entity sketches with detail lines in a book

The book view demonstrates why detailed study matters: once details are unlocked, an entity sketch page can show the studied entity name plus values such as health, armor, armor toughness, damage, and movement speed. The menu lets the player decide which unlocked lines belong on the page.

Position, Rotation, And Scale Controls

After placing an entity sketch in a writable book, you can adjust how the entity sits on the page.

ControlResult
Left mouse dragMoves the entity sketch across the page.
Mouse wheelScales the entity sketch up or down. The saved scale is clamped between 8 and 160.
Middle mouse dragRotates the entity sketch. Horizontal drag changes the rotation angle.

These transform controls apply while editing a writable book and while the cursor is over the entity sketch/page area. The client previews the change immediately, then sends the updated transform to the server after a short idle delay.

Detail Lines

Detailed study can unlock these optional notes for an entity page:

DetailSource
NameStored during the first identification pass.
HealthThe entity's maximum health.
ArmorThe entity's current armor value.
Movement SpeedThe movement speed attribute, if present.
Armor ToughnessThe armor toughness attribute, if present.
DamageThe attack damage attribute, if present.

Numbers are rounded cleanly. Whole numbers display without decimals; fractional values display with two decimals.

Spyglass Recipe

The study system uses Minecraft's vanilla Spyglass. The recipe is included here because it is the entry item for this feature.

Amethyst Shard
Copper Ingot
Copper Ingot
Spyglass

Advancements

Sketchbook adds a creature-study advancement tab.

AdvancementHow to earn it
SketchbookComplete a detailed study for any supported vanilla creature.
Detailed Study: <Creature>Complete a detailed study for that specific vanilla creature.
Grand BestiaryComplete every supported vanilla detailed-study advancement.

Only detailed studies award these advancements. The first identify pass is enough to place an entity sketch, but it does not complete the detailed-study advancement.

Vanilla advancement scope

The advancement tree is generated for supported vanilla Minecraft creatures. Modded living entities can still be identified, studied, and sketched, but they do not receive per-entity advancement entries unless the mod adds them separately.

Troubleshooting

SymptomLikely cause
No progress bar appearsYou are not actively using a Spyglass, the target is not living, the target is invisible, or another screen is open.
The study cancelsThe target moved out of range, left line of sight, died, or your aim moved off the hitbox.
The entity is not in the book menuThat specific entity type and visual variant has not been identified by your player yet.
Details cannot be toggledThe detailed pass has not been completed yet, or you do not have a usable Pencil when updating the page.

Support This Project

Like this wiki and these mods?

Every bit of support helps me keep building features, writing docs, and shipping updates.

Back to top