OllamaNPC — Dynamic AI NPC Dialogue (MZ)

Turn your NPCs into characters that actually talk back.

OllamaNPC connects RPG Maker MZ to a local AI model through Ollama, so your NPCs can hold real, in-character conversations with the player. You write a persona once — personality, knowledge, speech style, the facts they know — and the NPC improvises its own dialogue at runtime, in the normal message window, with its face and name.

It’s (Ollama Connection & Post Plugin Install) 100% free, runs fully offline, and uses no API keys and no cloud service. Nothing the player types ever leaves their machine.

Features

• Persona-driven NPCs — define character once, get endless in-character lines.
• Free typed input or scripted prompts — let players ask anything, or feed fixed lines for reactive dialogue.
• Per-NPC memory saved in the save file — NPCs remember across save/load.
• Shared world/lore context injected into every NPC.
• Live game data in dialogue via V[n], N[n], and {player}.
• Automatic word-wrap and pagination into the standard message window.
• A “thinking…” indicator, a configurable fallback line, and output sanitizing so replies can’t break your text codes.
• Simple plugin commands — no scripting required.

Requirements

• RPG Maker MZ (MZ only — not MV).
• Ollama installed on the machine running the game, with one model pulled (e.g. ollama pull llama3.2). A small model gives near-instant replies.

Quick start

1. Put OllamaNPC.js in js/plugins/ and enable it.
2. Set the Default Model to the model you pulled.
3. On an NPC event, add Plugin Command → OllamaNPC → Talk With Player Input with your persona’s key. That’s it — the player can now chat with the NPC.

Note on AI

This is an AI tool: it generates NPC dialogue at runtime using a local language model, and the plugin itself was built with AI assistance. It’s disclosed here for full transparency. All generation happens locally on the player’s machine.

Terms of use

Free for commercial and non-commercial RPG Maker MZ projects. Credit appreciated, not required. Don’t resell the plugin as-is. Provided “as is” without warranty. See readme.txt for full terms.

💬 Feedback, Support & Custom Development

Thank you for checking out this project! If you use this plugin, I’d greatly appreciate it if you could leave a review describing your experience. Your feedback helps improve future updates, assists other developers in making informed decisions, and supports continued development.

If you have any questions, bug reports, feature suggestions, or run into any problems while using this plugin, please don’t hesitate to contact me.

I’m also available for custom RPG Maker plugin development. Whether you need a completely new plugin, modifications to an existing one, compatibility fixes, or help implementing a unique gameplay system, I’d be happy to discuss your project.

📧 Contact: rpgmakerplugins@protonmail.com

I do my best to respond as quickly as possible and look forward to helping you bring your ideas to life. Thank you for your support!