api.lua

-- name => backend_def
local backends = {}

-- register a map backend
function mapsync.register_backend(name, backend_def)
    -- apply defaults
    backend_def.type = backend_def.type or "fs"

    minetest.log("action", "[mapsync] registering backend '" .. name ..
        "' with type '" .. backend_def.type ..
        "' from mod: '" .. (minetest.get_current_modname() or "<nil>") .. "'")

    backend_def.name = name
    -- default to always-on backend if no selector specified
    backend_def.select = backend_def.select or function() return true end

    -- register
    backends[name] = backend_def
end

-- unregisters a backend
function mapsync.unregister_backend(name)
    minetest.log("action", "[mapsync] unregistering backend '" .. name .. "'")
    backends[name] = nil
end

-- returns all backends
function mapsync.get_backends()
    return backends
end

-- returns the backend by name or nil
function mapsync.get_backend(name)
    return backends[name]
end

-- returns the matched backends
function mapsync.select_backends(chunk_pos)
    local matched_backends = {}
    for name, backend_def in pairs(backends) do
        if backend_def.select(chunk_pos) then
            matched_backends[name] = backend_def
        end
    end
    return matched_backends
end

-- returns the first match or nil
function mapsync.select_backend(chunk_pos)
    for _, backend_def in pairs(backends) do
        if backend_def.select(chunk_pos) then
            return backend_def
        end
    end
end

-- singleton
local data_backend_def

function mapsync.register_data_backend(def)
    data_backend_def = def
end

function mapsync.get_data_backend()
    return data_backend_def
end