You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Hector Kio a43233ff03
Merge pull request #53 from hkzorman/clean_api
3 years ago
backup Locations API: Improve building entrance algorithm. 3 years ago
doc Merge branch 'commands_api' of https://github.com/hkzorman/advanced_npc into commands_api 3 years ago
executable Allow ability to search for nodes on a height limit on node_query 3 years ago
info Improve tag finding algorithm with three search criterias: 3 years ago
locale First commit. Using mobs_npc code as start. 5 years ago
occupations Improve tag finding algorithm with three search criterias: 3 years ago
textures Spawner: Decouple logic in spawner and generalize, also include more features 3 years ago
trade Trading API: Improved Prices API to be more generic. 3 years ago
.gitignore Spawner API: Fix not finding correct occupations for different 3 years ago
README.md Fix README.txt and restore correct spawning frequency. 4 years ago
depends.txt Add proper description.txt, depends.txt 4 years ago
description.txt Add proper description.txt, depends.txt 4 years ago
dialogue.lua Dialogues and Relationships API: Allow to work without any defined 3 years ago
init.lua Initial tasks to separate API from all data definitions: 3 years ago
license.txt Adds pathfinding library Jumper by Ronald Yonaba. This includes an implementation of the A* pathfinding algorithm which makes NPC now always get to their goal node. 5 years ago
mod.conf Progress on gifts and relationships. Still requires further debugging to understand some timer issues. 5 years ago
npc.lua Improve tag finding algorithm with three search criterias: 3 years ago
relationships.lua Dialogues and Relationships API: Allow to work without any defined 3 years ago
spawner.lua Trading API: Improved Prices API to be more generic. 3 years ago
spawner_marker.lua Spawner: Large code refactor to remove dependency on plotmarkers. 4 years ago
utils.lua Places: Add truly owned nodes. NPCs shouldn't override ownership 4 years ago

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.