Skip to content
Advanced NPC for Minetest, using mobs_redo API
Branch: master
Clone or download
hkzorman Merge pull request #53 from hkzorman/clean_api
Make advanced_npc a pure API mod
Latest commit a43233f Jun 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
backup Locations API: Improve building entrance algorithm. Apr 19, 2018
doc Merge branch 'commands_api' of https://github.com/hkzorman/advanced_npc Apr 30, 2018
executable Allow ability to search for nodes on a height limit on node_query Jun 28, 2018
info Improve tag finding algorithm with three search criterias: Jun 23, 2018
locale First commit. Using mobs_npc code as start. Nov 12, 2016
occupations Improve tag finding algorithm with three search criterias: Jun 23, 2018
textures Spawner: Decouple logic in spawner and generalize, also include more … May 10, 2018
trade Trading API: Improved Prices API to be more generic. Jun 22, 2018
.gitignore Spawner API: Fix not finding correct occupations for different May 16, 2018
README.md Fix README.txt and restore correct spawning frequency. Jun 17, 2017
depends.txt Add proper description.txt, depends.txt Jun 17, 2017
description.txt Add proper description.txt, depends.txt Jun 17, 2017
dialogue.lua Dialogues and Relationships API: Allow to work without any defined May 16, 2018
init.lua Initial tasks to separate API from all data definitions: May 4, 2018
license.txt Adds pathfinding library Jumper by Ronald Yonaba. This includes an im… Jan 6, 2017
mod.conf Progress on gifts and relationships. Still requires further debugging… Nov 14, 2016
npc.lua Improve tag finding algorithm with three search criterias: Jun 23, 2018
relationships.lua Dialogues and Relationships API: Allow to work without any defined May 16, 2018
spawner.lua Trading API: Improved Prices API to be more generic. Jun 22, 2018
spawner_marker.lua Spawner: Large code refactor to remove dependency on plotmarkers. Aug 25, 2017
utils.lua Places: Add truly owned nodes. NPCs shouldn't override ownership Oct 7, 2017

README.md

advanced_npc

Introduction

Advanced NPC is a mod for Minetest using mobs_redo API. The goal of this mod is to be able to have live villages in Minetest. These NPCs are highly inspired by the typical NPCs of Harvest Moon games. The general idea is that on almost all buildings of a village there are NPCs that are kind of intelligent: they have daily tasks they perform, can speak to players, can trade with the player, can use their own items (chests and furnaces for example), know where to go around their house and village, can be lumbers, miners or any other Minetest-suitable profession and can ultimately engage into relationships with the player. And while basically only players are mentioned here, the ultimate goal is that they can do all of this also among themselves, so that villages are alive and evolving by themselves, without player intervention.

Installation

NOTE: Advanced NPC is still under development. While the mod is largely stable, it lacks one of the most important pieces: spawning. Currently, NPCs can be spawned using eggs (found in creative inventory as 'NPC') and by themselves on villages of the mg_villages mod. NPCs will spawn automatically on mg_villages villages and over time will populate the entire village. If something goes wrong, you can reset the village by:

  • Clearing all objects (in chat, type /clearobjects quick)
  • Restore original plotmarkers (in chat, type /restore_plotmarkers radius)
    • The radius can be any number, but it is recommended you use a not so large number. 200 is suitable. So stand in the middle of the village and then run that command. This will actually restore the village and will slowly make NPCs spawn again. Currently there's no way to disable NPCs spawning on village, except by going to spawner.lua and commenting out all of minetest.register_abm() code.

Download the mod here (link always pointing to latest version)

For this mod to work correctly, you also need to install the mobs_redo mod. After installation, make sure you enable it in your world.

License

advanced_npc is Copyright (C) 2016-2017 Hector Franqui (zorman2000), licensed under the GPLv3 license. See license.txt for details.

The pathfinder.lua file contains code slighlty modified from the pathfinder mod by MarkBu, which is licensed as WTFPL. See actions/pathfinder.lua for details.

Current NPC textures are from mobs_redo mod. The following textures are by Zorman2000:

  • marriage_ring.png - CC BY-SA

Documentation and API

This mod requires a good user manual, and also is planned to have an extensive API, properly documented. Unfortunately, these still aren't ready. A very very very WIP manual can be found in the wiki

Roadmap

See it on the wiki.

You can’t perform that action at this time.