Camera Obscura

Take photos of your world / server!
When used on a server: no client side mods required!
Everything is rendered on the server using raycasting.

Item:

The mod adds a Camera Item, for clients it looks and functions like a normal spyglass but has a custom name and consumes a map item or other, as specified in the configs.

There is no recipe for the item (yet)

/give @s camera-obscura:camera

Configs

The config file will be created on first launch and is located in
configs/camera-obscura.json

Example config with default values:

{
  "renderDistance": 128,
  "showSystemMessages": false,
  "renderEntities": false,
  "renderEntitiesAmount": 20,
  "fullbright": false,
  "fov": 70,
  "biomeBlend": 1,
  "cameraItem": "minecraft:spyglass",
  "cameraConsumesItem": true,
  "cameraConsumeItem": "minecraft:map",
  "commandPermissionLevel": 2
}

Explanation:

• renderDistance: Render distance in blocks
• showSystemMessages: Flag wether system messages should be shown when a photo is being taken when run as command, default is false
• renderEntities: Flag for experimental entity rendering, default is false
• renderEntitiesAmount: Amount of entities to render when entity rendering is enabled, default is 20
• fullbright: Flag wether light levels should be ignored, rendering everything with the highest light level. Default is false
• fov: Field of View, functions the same way the vanilla client FOV works, minimum value is 30, maximum 110 (Quake Pro). Default is 70
• biomeBlend: Biome blend value
• cameraItem: Vanilla Item to use as camera item model/texture, default is minecraft:spyglass
• cameraConsumesItem: Flag if an item should be consumed, default value is true
• cameraConsumeItem: Item to consume when the camera item is used. No items will be consumed when ran as command, default is minecraft:map
• commandPermissionLevel: Vanilla Permission level, default value is 2

Commands:

/camera-obscura

Takes a picture of the player running the command and gives the resulting map item to that player

---

/camera-obscura <[Entity|Player]> <scale>

Takes a picture as the source entity and gives the player the resulting maps, a scale of up to 3 (3x3 maps) can be specified optionally.

---

/camera-obscura save

Takes a picture of the player running the command and saves it as png in
renders/<imagename>.png,
where imagename is the current date in the format
yyyy-MM-dd HH:mm:ss.SSS

---

/camera-obscura save <Entity> <scale>

Takes a picture as the source entity and gives the player the resulting maps, a scale of up to 10 (1280px * 1280px) can be specified optionally.

Default image size is 128px * 128px

---

/camera-obscura clear-cache

Clears the cache (textures, resourcepack models and blockstate definitions, cached render models)

Permissions:

Default Vanilla permission level is 4, this can be configured with commandPermissionLevel For luckperms, etc. - those should be self-explanatory:

---

camera-obscura.command
camera-obscura.command.scale

---

camera-obscura.command.entity
camera-obscura.command.entity.scale

---

camera-obscura.command.save
camera-obscura.command.save.scale

---

camera-obscura.command.save.entity
camera-obscura.command.save.entity.scale

---

camera-obscura.clear-cache

---

Known Issues:

All of those will be fixed sooner or later

• Entity rendering is slow and doesn't support all entities
• Liquids are "blocky"
• Hard lighting
• End Gateway and end portal blocks are pure black (they use the black concrete texture temporarily)
• Models that are larger than a single block can get cut-off during rendering
• Rendering breaks with coordinates in the millions

How it works:

The game assets are downloaded from mojangs servers and read to render the world using raytracing.
When the render is done, a Map item with the image is created or a png is saved to the renders folder.

---

Test Sever

Join the test server with a 1.21.4 client on

mc.tomalbrc.de:25565

to test this mod and my other mods + upcoming, unreleased mods and features!