Simple NPC

(https://github.com/WindWavesSea/Simple-NPC/blob/main/README_en.md) [简体中文](https://github.com/WindWavesSea/Simple-NPC/blob/main/README.md)

# Introduction

This data pack makes configuring NPCs in vanilla Minecraft much easier. Simply write the required data into the storage and execute the summon function to create your own NPC.

The following features are supported:

Custom floating text displayed above the NPC. Custom NPC skin. * Execute a command or function when the NPC is right-clicked.

# Storage Structure

## Default Structure (Custom Settings Disabled)

!(https://cdn.modrinth.com/data/cached_images/61f6075c37dfd9bae946aeeca73b3607cdcfe5be.png)

## Custom Structure (Custom Settings Enabled)

!(https://cdn.modrinth.com/data/cached_images/53cf2c6af99522baf0eda5aeae6e252aa226e636.png)

## Example Storage

### Default Configuration

~~~mcfunction data modify storage windwaves_sea:npc root.npc_setting merge value {\ test:{\ name:"test",\ zone:"test",\ config:{\ custom_settings:false,\ look_player:true\ },\ text:{\ pos:{x:1,y:1,z:1},\ text:[{text:"1"}]\ },\ npc:{\ pos:{x:1,y:1,z:1},\ model:"wide",\ texture:"lobby:npc/start_game",\ rotation:\ },\ right_click:{\ command:"",\(function:""\) }\ }\ } ~~~

### Custom Configuration

~~~mcfunction data modify storage windwaves_sea:npc root.npc_setting merge value {\ test_custom:{\ name:"test_custom",\ zone:"test",\ config:{\ custom_settings:true,\ look_player:true,\ default_orientation:"north" \ },\ text:{\ pos:{x:1,y:1,z:1},\ data:{}\ },\ npc:{\ pos:{x:1,y:1,z:1},\ data:{}\ },\ right_click:{\ function:""\(command:""\) }\ }\ } ~~~

# Command Reference

## Summon an NPC

~~~mcfunction function npc:summon {name:"name"} ~~~

Summons an NPC. The configuration must be written to storage before running this function. Duplicate NPCs cannot be spawned. `name` refers to the NPC name defined in the configuration above (the same applies below).

## Remove an NPC

~~~mcfunction function npc:remove/npc {name:"name"} ~~~

## Remove the Configuration (Also Removes the NPC)

~~~mcfunction function npc:remove/setting {name:"name"} ~~~

QQ Group: 117464315

GitHub: https://github.com/WindWavesSea/Simple-NPC/

# Acknowledgements

Special thanks to (https://space.bilibili.com/1184771713) for providing the interaction entity size solution, allowing interaction entities to properly match NPC hitboxes.

Special thanks to [轩宇1725](https://space.bilibili.com/104432208) for providing the storage detection approach, enabling string-based detection.