A minetest mod for mapmaking
Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.
sys4 4532b2b3c9 Add loading message to action log 2 недель назад
models Add advanced table assets 4 месяцев назад
sounds Add feedback sounds for table-related actions, and make sounds play for everyone 3 месяцев назад
textures Add height mode toggle to maps 3 месяцев назад
.gitignore Add graphics for 2nd tier table 5 месяцев назад
.gitlab-ci.yml Add gitlab CI configuration to run luacheck automatically 2 месяцев назад
.luacheckrc Fix remaining luacheck warnings 2 месяцев назад
CHANGELOG.md Preparation for release 1 месяц назад
LICENSE-ccbysa4 Add license files 2 месяцев назад
LICENSE-gplv3 Add license files 2 месяцев назад
README.md Add license files 2 месяцев назад
audio.lua Documentation pass, part 1 2 месяцев назад
autofill.lua Resolve TODOs 1 месяц назад
biome_api.lua Documentation pass, part 1 2 месяцев назад
chunk_api.lua Refactor marker_lookup out of init.lua 2 месяцев назад
commands.lua Remove testing command 2 месяцев назад
formspec.lua Formspec background fixes 1 месяц назад
init.lua Add loading message to action log 2 недель назад
items.lua Fix luacheck warnings 1 месяц назад
map_api.lua Remove unused variable 1 месяц назад
map_formspec.lua Fix coordinates being handled incorrectly in some places 2 месяцев назад
marker_api.lua Documentation pass, part 2 2 месяцев назад
material_api.lua Documentation pass, part 2 2 месяцев назад
mod.conf Documentation pass, part 2 2 месяцев назад
scanner.lua Fix bounds-checking on marker pages 1 месяц назад
screenshot.png Update screenshot: Make logo larger 1 месяц назад
screenshot.xcf Update screenshot: Make logo larger 1 месяц назад
settingtypes.txt Resolve TODOs 1 месяц назад
skin_api.lua table formspec fixes 1 месяц назад
storage.lua Add configuration settings 2 месяцев назад
table.lua Formspec background fixes 1 месяц назад
util.lua Documentation pass, part 3 2 месяцев назад

README.md

Cartographer

A Minetest mod that provides the necessary framework for crafting maps of the local environment from various resources. The mod is structured as an API of sorts, to allow it to be used with any game where such concepts are sensible.

How to set up Cartographer

Since Cartographer is an API, it needs at least one additional mod in order to function in your world. There are example mods available for Minetest Game and Repixture, and you can make your own to extend these or support other games of your choosing.

The process of making such a mod is pretty straightforward:

  1. Register every biome in your game with cartographer, by calling cartographer.biomes.add, listing the biome, texture names to use for each detail level, and an optional min/max height for those textures to be used.
  2. Register items/item groups that provide “paper” and “pigment” for mapmaking, by calling cartographer.materials.register_by_name or cartographer.materials.register_by_group. You can optionally specify how much of a material to provide per-item, or let it provide 1 unit by default.
  3. Add crafting recipes or other ways of acquiring the following nodes:
    • cartographer:simple_table
    • cartographer:standard_table
    • cartographer:advanced_table
  4. When integrating into a game, you can use cartographer.skin (skin_api.lua) to re-skin this mod's UI with your own textures and better integrate the mod with your art direction.

It's worth looking in the code to see what other options the cartographer API offers. If your mod/game would benefit from another means of acquiring or displaying maps, you can use the API to create your own crafting systems and mapping items.

Contact

For questions, requests, and other communications regarding this work, you can contact the original creator at hugues.ross@gmail.com

License

Cartographer's code is licensed under the GNU General Public License v3.0. A copy of this license should be bundled with this work, if one was not provided then you can find the license here

Cartographer's visual/audio assets are licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. A copy of this license should be bundled with this work, if one was not provided then you can find the license here