{"id":16374962,"url":"https://github.com/sovdeeth/skript-maps","last_synced_at":"2026-03-31T16:30:17.545Z","repository":{"id":215381977,"uuid":"738794015","full_name":"sovdeeth/skript-maps","owner":"sovdeeth","description":"Skript addon for drawing stuff on maps","archived":false,"fork":false,"pushed_at":"2024-01-07T03:39:10.000Z","size":56,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-01T04:15:02.055Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sovdeeth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-01-04T04:04:01.000Z","updated_at":"2024-05-06T16:49:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"6cfeb92d-2060-4932-9e21-399938e6e6e0","html_url":"https://github.com/sovdeeth/skript-maps","commit_stats":null,"previous_names":["sovdeeth/skript-maps"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-maps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-maps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-maps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-maps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sovdeeth","download_url":"https://codeload.github.com/sovdeeth/skript-maps/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239954698,"owners_count":19724286,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-11T03:18:58.695Z","updated_at":"2026-03-31T16:30:17.509Z","avatar_url":"https://github.com/sovdeeth.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skript-Maps\n\nThis addon is meant to assist Skript users in drawing their own custom content onto maps. Currently, this addon is in **alpha** and has limited syntax.\nExpect issues and bugs, or unfinished content.\n\nIt supports:\n* drawing text onto maps\n* drawing images onto maps\n* loading images from a specific directory\n* colouring specific pixels, lines, rectangles, or circles a certain colour\n* managing multiple layers of rendering on a map\n\nMaps are not saved through server restarts, however, so be warned!\n\n## Code Example\n```applescript\ncommand test:\n    trigger:\n        set {_item} to a filled map\n        set {_view} to new map view in world \"world\"\n\n        set {_layer} to new fixed map layer:\n            draw resized map image named \"windmillsmall.jpg\" on the map at pixel 0, 0\n            \n        set {_x} to 0\n        set {_y} to 0 \n        set {_layer2} to new map layer:\n            colour pixels between pixel 20, 20 and pixel 108, 20 on the map blue\n            colour pixels between pixel 20, 20 and pixel 64, 44  on the map blue\n            colour pixels between pixel 64, 44 and pixel 108, 20 on the map blue\n            colour pixels in radius 20 of pixel 100, 100 on the map green\n            render an oval with width 10 and height 25 at pixel 50, 80 on the map in rgb(183,50,100)\n            colour pixel {_x}, {_y} on the map red\n            add 1 to {_x}\n            if {_x} is 128:\n                set {_x} to 0\n                add 1 to {_y}\n\n\n        set map layers of {_view} to {_layer}, {_layer2}\n\n        set map view of {_item} to {_view}\n        give {_item} to player\n```\n\n## Syntax:\n### Effects\n#### Draw Map Content\n```\n(draw|render) %image/string% on the map at %mappixel%\n```\nDraws text or images on a map. Must be used in a map layer section.\n\n**Examples**\n```\nset {_img} to the map image from file \"myimage.png\"\nset {_layer} to a new map layer:\n  draw {_img} on the map at pixel 0, 0\n  draw \"%mapColor(red)%%Hello, world!\" on the map at pixel 40, 60\n```\n***\n\n#### Draw Map Pixels\n```\ncolo[u]r %mappixels% on the map [as] %color%\n```\nSets the color of one or more pixels on a map. Must be used in a map layer section.\n\n**Examples**\n```\nset {_layer} to a new map layer:\n    color the pixel at 0, 0 on the map as red\n```\n***\n\n#### Draw Map Line\n```\ncolo[u]r [the] pixels (between|from) %mappixel% (and|to) %mappixel% on the map [as] %color%\n(draw|render) [a] line (between|from) %mappixel% (and|to) %mappixel% on the map [with|in|using] %color%\n```\nDraws a line on a map. Must be used in a map layer section.\n\n**Examples**\n```\nset {_layer} to a new map layer:\n    colour the pixels between pixel 0, 0 and pixel 127, 127 on the map red\n    draw a line from pixel 88, 20 to pixel 40, 20 on the map using red\n```\n***\n\n#### Draw Map Oval\n```\ncolo[u]r [the] pixels in radius %number% [of|around] %mappixel% on the map [as] %color%\n(draw|render) [a] [solid] circle (with|of) radius %number% (at|around) %mappixel% on the map [with|in|using] %color%\n(draw|render) [a[n]] [solid] oval (with|of) width %number% and height %number% (at|around) %mappixel% on the map [with|in|using] %color%\n```\nDraws an oval or a circle on a map. Must be used in a map layer section.\n\n**Examples**\n```\nset {_layer} to a new map layer:\n    colour the pixels in radius 25 of pixel 127, 127 on the map red\n    draw an oval of width 20 and height 30 around pixel 40, 20 on the map using red\n```\n***\n\n#### Draw Map Rectangle\n```\ncolo[u]r [the] pixels witihin %mappixel% (and|to) %mappixel% on the map [as] %color%\n(draw|render) [a] [solid] rect[angle] (within|from) %mappixel% (and|to) %mappixel% on the map [with|in|using] %color%\n```\nDraws a rectangle on a map. Must be used in a map layer section.\n\n**Examples**\n```\nset {_layer} to a new map layer:\n    colour the pixels within pixel 0, 0 and pixel 127, 127 on the map red\n    draw a rectangle from pixel 88, 20 to pixel 40, 40 on the map using red\n```\n***\n\n### Expressions\n#### Map Image\n```\n[the] [resized] map image [from file|named] %string%\n```\nLoads an image from a file. The image must be in the plugins/skript-maps/images folder. Take care not to do this too often, as it can cause lag.\nIf `resized` is used, the image will be resized to 128x128 pixels, which is the size of a whole map.\n\n**Examples**\n```\nset {_img} to the resized map image from file \"myimage.png\"\nset {_layer} to a new map layer:\n    draw {_img} on the map at pixel 0, 0\n```\n***\n\n#### Map Pixel\n```\n[the] [map] pixel [at] %number%,[ ]%number%\n```\nRepresents the coordinates of a pixel on a map.\n\n**Examples**\n```\nset {_pixel} to the map pixel at 0, 0\nset {_layer} to a new map layer:\n    colour the pixel at {_pixel} on the map blue\n    draw a rectangle from pixel 100, 100 to {_pixel} on the map using blue\n```\n***\n\n#### Map Layers\n```\nmap layers of %mapview%\n%mapview%'[s] map layers\n```\nThe layers of a map. Each layer can have its own code for drawing on the map, and their contents will be drawn to the map in order.\nThis means the last layer will be drawn on top of the others.\n\nLayers can be added or removed at any time, and their order can be changed by removing and re-adding them.\n\n**Examples**\n```\nset map layers of {_map-view} to reversed map layers of {_map-view}\nset map layers of {_map-view} to {_layer1}, {_layer2}, {_layer3}\nclear map layers of {_map-view}\nadd {_layer} to map layers of {_map-view}\nremove {_layer} from map layers of {_map-view}\n```\n***\n\n#### Map View\n```\nmap view of %itemstacks%\n%itemstacks%'[s] map view\n```\nThe map view of an item stack. This can be used the change the properties of a displayed map, or have layers \nadded and removed to change the content of the map.\n\nIf a map item does not yet have a map view, this will return nothing. You can use the \"new map view\" expression instead.\n\nBe warned, resetting this property may clear the map, or it may cause the map to be completely regenerated as\nan entirely new map, depending on your server jar.\n\n**Examples**\n```\nset {_map} to a new map\",\nset {_view} to {_map}'s map view\nset {_view}'s map scale to 2\nset {_map}'s map view to {_view}\n```\n***\n\n#### New Map View\n```\n[a[n]] [new] [empty] map view [in [world] %world%]\n[a[n]] [new] map view (from|with) id %number%\n```\nCreates a new empty map view. This is not a map item, but a map view that can be used to render a map.\nTo assign this map view to a map item, use `set {_map}'s map view to {_view}`.\n\nThis can also be used to get a map view from its id. If a map view with the given id does not exist, this will return null.\n\n**Examples**\n```\nset {_view} to a new map view\nset {_layer} to a new map layer:\n    color pixels within pixel 0, 0 and pixel 127, 127 on the map blue\nadd {_layer} to map layers of {_view}\nset {_map}'s map view to {_view}\n```\n***\n\n### Sections\n#### New Map Layer Section\n```\nset %variable% to [a] [new] [fixed] map layer\n```\nCreates a new map layer. This is not a map item, but a map layer that can be used to render a map.\n\nThe code inside this section will be run every time the map is rendered, which is every five ticks for \neach map item in a player's inventory and approximately every 50 ticks for each map on an item frame.\n\nThese can add up quickly, so keep your code as efficient as possible inside the section. Alternatively, you can use the \"fixed\" tag to render the layer only once per player.\n\nAlso, note that local variables will persist through each render. This allows you to, for example, keep track \nof how many times the layer has been rendered by adding 1 to a local variable each time.\n\n**Examples**\n```\nset {_layer} to a new map layer:\n    color pixels within pixel 0, 0 and pixel 127, 127 on the map blue\nadd {_layer} to map layers of {_view}\n```\n***\n\n### Functions\n#### Map Colour\n```\nmapColor(color: color)\nmapColorRGB(red: int, green: int, blue: int)\n```\nReturns a map colour string from red, green, and blue values, or from a Skript colour, for use in colouring text on maps. This colour \nwill not be exact, as there is a limited number of colours available on maps. The colour string is in the format `\"§x;\"`, where `x` is the code for the map colour.\n\n**Examples**\n```\ndraw \"%mapColor(blue)%text\" at 0, 0 on the map\ndraw \"%mapColorRGB(1, 30, 230)%text\" at 0, 0 on the map\n```\n***\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsovdeeth%2Fskript-maps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsovdeeth%2Fskript-maps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsovdeeth%2Fskript-maps/lists"}