SpyGlassMe

SpyglassMe - Shrink & Grow Your World!

Ever wanted to shrink a creeper to the size of a silverfish, or make your pet wolf a towering giant? SpyglassMe introduces two magical spyglasses that let you alter the size of almost any entity in the world! Gaze through the Shrinking Glass to make things tiny, or the Growing Glass to make them colossal. Your world, your scale!

---

Features

Magical Spyglasses

• Shrinking Glass & Growing Glass: Two new custom-textured spyglasses that serve as your tools for reality-bending fun.
• How to Obtain: The spyglasses can be crafted using the default recipes or found as treasure in loot chests! Both methods can be customized.

Dynamic Scaling

• Simple to Use: Just look at an entity (players, animals, or monsters) and hold right-click to continuously change their size. You can even look down to change your own size!
• Highly Configurable: Use settings.yml to control the SCALE_STEP (how much size changes) and SCALE_PER (whether the effect applies per "tick" or per "second").
• Target Permissions: Fine-grained permissions allow you to control who can resize other players, animals, mobs, or themselves.

Configurable Cost System

• Pay to Play: Set a cost for using the spyglasses in the settings.yml config file. Costs for shrinking and growing can be configured independently.
• Cost Types: Choose between xp, item (e.g., minecraft:diamond), economy (integrates with server economy plugins via command), or none.
• Bypass: Players with the SpyGlassMe.bypass.cost permission can use the spyglasses for free.

Safety Limits & Bypasses

• Keep Chaos in Check: Configure server-wide MIN_SCALE and MAX_SCALE limits to prevent players from creating microscopic or world-breakingly large entities.
• Go Beyond: Admins or VIPs with the SpyGlassMe.bypass.limits permission can ignore the configured scale limits.

The Milky Way Back to Normal

• Reset Yourself: Drank a little too much growing potion? Drinking a standard Milk Bucket will instantly reset your own size back to default.
• Reset Others: Made a friend a bit too tiny? Right-clicking any entity with a Milk Bucket will return them to their normal size.

---

Datapack & Customization

SpyglassMe is designed to be easily customized by server owners!

• Auto-Generated Datapack: When a world is first loaded, the mod automatically creates a SpyGlassMe datapack inside your world's datapacks folder. This contains the default crafting recipes, which you can edit freely.
• Easy Loot Customization: To add the spyglasses to loot chests, we provide an optional pre-configured datapack with common loot tables.
  1. Download the loot datapack here: SpyGlassMe Loot Datapack
  2. Copy the loot table files from the download into the mod's auto-generated datapack folder (/datapacks/SpyGlassMe/...).
  3. Run /reload in-game. This gives you full control to add or remove spyglasses from any structure's chests!
• Reloading: Recipe and loot changes require the vanilla /reload command, while config changes in settings.yml require /spyglassme reload.

---

Commands

• /spyglassme or /sg: Shows the main help page for the mod.
• /spyglassme reload: Reloads the settings.yml config file.
• /spyglassme give <type> <player>: Gives a player one of the special spyglasses.
• /size: Resets your own size to the default (1.0).
• /size get <player>: Checks the current size of another player.
• /size <value|preset> [player]: Directly sets the scale for yourself or another player. Presets include tiny, normal, giant, and more!

---

Single-Player & Permissions Notes

• Single-player: All features are available by default without any special setup.
• Multiplayer: This mod uses the Fabric Permissions API. For full control over who can do what, a compatible permission manager (e.g., LuckPerms) is recommended on the server.
• Default Behavior: If no permissions manager is found, permissions default to the required operator level (e.g., OP Level 4 for admin commands).

Click to view all permission nodes and their descriptions

• SpyGlassMe.command.use: Allows use of the /spyglassme base command.
• SpyGlassMe.command.reload: Allows use of the /spyglassme reload command.
• SpyGlassMe.command.give: Allows use of the /spyglassme give command.
• SpyGlassMe.command.size.self: Allows a user to change their own size with /size.
• SpyGlassMe.command.size.other: Allows a user to change another player's size with /size.
• SpyGlassMe.bypass.cost: Allows a user to use spyglasses without paying the cost.
• SpyGlassMe.bypass.limits: Allows a user to scale entities beyond the configured min/max limits.
• SpyGlassMe.size.mobs: Allows a user to use spyglasses on hostile/neutral mobs.
• SpyGlassMe.size.animal: Allows a user to use spyglasses on passive animals.
• SpyGlassMe.size.self: Allows a user to use spyglasses on themselves.
• SpyGlassMe.size.other: Allows a user to use spyglasses on other players.
• SpyGlassMe.size.prevent: Makes the player immune to size changes from other players.

---

Modpack Policy

• You ARE PERMITTED to include this mod in any modpack.
• Please do not modify the mod's JAR file directly.
• The modpack itself, or access to this mod within the modpack, must not be sold.