{"id":40897480,"url":"https://github.com/jensjeflensje/minecraft_imagery","last_synced_at":"2026-01-22T02:25:20.383Z","repository":{"id":180076886,"uuid":"655396697","full_name":"jensjeflensje/minecraft_imagery","owner":"jensjeflensje","description":"Toolkit for taking pictures and videos in Minecraft","archived":false,"fork":false,"pushed_at":"2025-02-04T09:08:20.000Z","size":3054,"stargazers_count":18,"open_issues_count":11,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-04T10:20:37.048Z","etag":null,"topics":["minecraft","raytracing","spigot","spigot-api"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/imageryapi-take-pictures-in-minecraft.111347/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jensjeflensje.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://premium.onlyjens.nl"}},"created_at":"2023-06-18T19:08:59.000Z","updated_at":"2025-02-04T09:08:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"bee8a5f0-1c63-41fb-ad60-771c98dae6d3","html_url":"https://github.com/jensjeflensje/minecraft_imagery","commit_stats":null,"previous_names":["jensjeflensje/minecraft_imagery"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/jensjeflensje/minecraft_imagery","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jensjeflensje%2Fminecraft_imagery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jensjeflensje%2Fminecraft_imagery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jensjeflensje%2Fminecraft_imagery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jensjeflensje%2Fminecraft_imagery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jensjeflensje","download_url":"https://codeload.github.com/jensjeflensje/minecraft_imagery/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jensjeflensje%2Fminecraft_imagery/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28651450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft","raytracing","spigot","spigot-api"],"created_at":"2026-01-22T02:25:19.708Z","updated_at":"2026-01-22T02:25:20.378Z","avatar_url":"https://github.com/jensjeflensje.png","language":"Java","funding_links":["https://premium.onlyjens.nl"],"categories":[],"sub_categories":[],"readme":"# ImageryAPI\nA toolkit for taking pictures and videos in Minecraft.\nIt renders **server-side** images from a `Bukkit Location`'s perspective.\nThis library mainly consists of an image capture utility\nwhich will return images when given a location (and sometimes other options).\nIt looks something like this (left is generated by ImageryAPI, right is a normal Minecraft screenshot):\n\n![](media/examples/image1.png) \u003cimg src=\"media/examples/minecraft1.png\" height=\"128\"/\u003e\n\n![](media/examples/image4.png) \u003cimg src=\"media/examples/minecraft4.png\" height=\"128\"/\u003e\n\nIt also supports basic rendering of players.\nThat would look something like this:\n\n![](media/examples/image2.png) \u003cimg src=\"media/examples/minecraft2.png\" height=\"128\"/\u003e\n\n![](media/examples/image3.png) \u003cimg src=\"media/examples/minecraft3.png\" height=\"128\"/\u003e\n\nIt works by raytracing pixels of the picture and transforming every block into a color.\nIt also applies certain filters to the color depending on light level,\nor translucent blocks in front of it (e.g. stained glass).\n\n### Video frame capture\nThis library also has a video frame capture utility.\nThe goal of this utility is to render a frame very quickly\n(or at least fast enough that it can be somewhat useful to creating a 5fps video :P).\nThis utility is way faster than an image capture,\nbut compromises quite a lot on looks and accuracy.\n\n**Video frame capture is a very experimental feature.**\nAny ideas or PRs that will improve it are greatly appreciated.\n\n## Getting started\nThe library is a separate plugin which you install in your server\nin order to access it inside your own plugin.\n\nJust install a release version of the library as a plugin,\nand you're most likely ready to start development.\n\n### Developer guide\nStart using ImageryAPI as a dependency by including it in your pom.xml like this:\n```xml\n\u003c!-- Repository (if not already present) --\u003e\n\u003crepository\u003e\n    \u003cid\u003ejitpack.io\u003c/id\u003e\n    \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n\u003c/repository\u003e\n\n\u003c!-- Dependency --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.jensjeflensje\u003c/groupId\u003e\n    \u003cartifactId\u003eminecraft_imagery\u003c/artifactId\u003e\n    \u003cversion\u003e1.2.2\u003c/version\u003e\n    \u003cscope\u003eprovided\u003c/scope\u003e\n\u003c/dependency\u003e\n```\nPlease refer to [this readme](./src/main/java/dev/jensderuiter/minecraft_imagery/image/README.md)\nfor the developer guide on image captures.\n\n### Skript integration\nApart from the library supporting Java integrations (which is its primary goal),\na Skript integration can also be used. Please check out [this readme](./src/main/java/dev/jensderuiter/minecraft_imagery/skript/README.md).\n\n### Storage system\nThe library also has an easy-to-use storage system for generated images.\nPlease refer to [this readme](./src/main/java/dev/jensderuiter/minecraft_imagery/storage/README.md)\nfor more information about this feature.\n\n### Permissions\nEvery admin permission requires the `imageryapi.admin` permission.\n\n### Configuration (config.yml)\nYou can use the config.yml file to customize the color of each block.\nSome servers may like a more vibrant color palette, or something completely different.\nIt'll look something like this:\n```yaml\nblocks:\n  cobblestone: 127,127,127\n  bricks: 150,97,83\n  # ...\n```\n\nEach entry represents a material with an RGB color code.\nMake sure that any changes you make will still follow this format.\nYou're free to change every block color you like.\n\nTo apply changes inside this config, execute `/imageryapi reloadconfig`.\nOf course, reloading or restarting also works.\n\nIf you mess something up, you can always execute `/imageryapi savedefaults`\nto revert your config to the default one (your changes will be forever destroyed).\n\n`/imageryapi generatedefaults` is mostly meant for developers.\nIt will regenerate every block color entry it has an texture from,\nand compute the color for the config (average color).\nThis will overwrite every color entry the plugin has with a newly computed one.\n**Only use this if you're upgrading from an older version of ImageryAPI\nand want to update old colors (overwrite them) or add new ones that didn't exist before.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjensjeflensje%2Fminecraft_imagery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjensjeflensje%2Fminecraft_imagery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjensjeflensje%2Fminecraft_imagery/lists"}