Как я создал дополнение для чата в minecraft

Совсем недавно, тоесть пару месяцев назад, я задумался — «Хм, что можно сделать такое, что бы понравилось людям?». Я начал раздумывать, что можно сделать такое — npc окна это php, чат тоже php.. Стоп, дополнение для чата можно сделать на JavaScript. И вот я начал делать это дополнение для minecraft bedrock, точнее, не дополнение, а аддон.

Аддон этот был написан на JavaScript, по меньшей части JSON. В этой статье я расскажу, как я создавал этот аддон, как его создать самому и зачем. Давайте начнём.

Пустой аддон, но отображаемый

В самом начале разработки, необходимо создать пустой аддон, чтобы потом использовать js. Для этого, по пути Android/data/com.mojang…/files/games/com.mojang/behaivor_packs/ создаёте папку вашего аддона, можно с любым названием. У меня это chat_dino.

Далее нужно создать сам файл отображения. Название его должно быть manifest.json. Вот пару функций, которые должны содержаться в манифесте:

«name» и «description». Они отвечают за название и описание.
«version» и «uuid». Они отвечают за версию и уникальный айди набора.
Пути, по которым расположены скрипты. Их обязательно надо указать, чтобы скрипты работали.

В нашем случае, пути к скриптам будут в папке scripts. Давайте напишем код файла manifest.json на JSON:

{   "format_version": 2,   "header": {     "name": "Название",     "description": "Описание",     "uuid": "Уникальный id",     "version": [ 1, 0, 3 ],     "min_engine_version": [ 1, 14, 0 ]   },   "modules": [     {       "description": "Описание",       "type": "data",       "uuid": "Уникальный id 2",       "version": [ 1, 0, 0 ]     },     {       "description": "Описание",       "language": "javascript",       "type": "script",       "uuid": "Уникальный id 3",       "version": [0, 0, 1],       "entry": "scripts/main/index.js"     }   ],   "dependencies": [     {       "uuid": "Уникальный id 4",       "version": [ 0, 1, 0 ]     },     {       "uuid": "Уникальный id 5",       "version": [ 0, 1, 0 ]     }   ] }

Мы написали код для нашего аддона. Уникальный id — это id, использующийся для того, чтобы не путать один аддон с другим. Его можно сгенерировать на любом сайте, например, uuidgener*tor.net. Вместо * используйте a (англ.), просто боюсь нарушить авторские права. И каждый уникальный id должен быть разным, тоесть в нашем манифесте нужно 5 разных uuid. Теперь зайдем в майнкрафт, взглянем во вкладку «наборы параметров» — там появился наш аддон. Правда, пока что он пустой. Если у вас ничего не получилось, проверьте правильность uuid, или вместо Android/data/… используйте games/com.mojang/…

Создаём необходимые пути

В папке нашего аддона, там где манифест, создаёте 2 папки — scripts и functions. В папке scripts создайте папку main. А в main создайте файл index.js и папку misc. В парке misc создайте 2 файла — chat.js и second.js.

Далее определяемся с функциями — в папке functions создаёте папку func1. А в func1 файл func1.mcfunction.

Под конец в папке аддона создадим папку pack_icon.jpg, в которой будет иконка аддона.

А зачем?

При создании аддона возникает вопрос — «А зачем?». Ответ прост. Для сервера необходим антиспам и дополнение для чата. Если раньше сообщения выглядили так:

<nickname> Привет

То будут выглядеть вот так:

[Player] nickname: Привет

Круто, правда? Также пользователь не сможет писать 2 раза одни и теже сообщения либо не сможет писать их слишком быстро.

Вот как выглядит это в чате:

Пишем скрипты

Для начала разберёмся с функциями. Функции — это много команд в одной. В нашем случае, команда выглядит так:

/function func1/func1

Функция func1 расположена в папке func1. Вот скрипт этого добра:

gamerule commandblockoutput false gamerule sendcommandfeedback false

Оно просто отключает уведомления в чате. Чтобы оно работало автоматом, нужно поставить командной блок (цикл, раб. всегда) с командой /function func1/func1. Но это же не удобно?! Давайте автоматизируем этот процесс. Я не указал этого в путях, но укажу здесь. В папке functions создайте файл tick.json. Он будет отвечать за автоматическое выполнение функций. Запишем JSON код

{ "values": [ "func1/func1" ] }

Готово. Мы закончили с функциями.

Теперь переходим к JavaScript — запишем этот код в файле index.js

import { chatrank } from './misc/chat.js' import { world } from 'mojang-minecraft' import { timer } from './misc/second.js' let tick = 0, worldLoaded = false, loadTime = 0;  world.events.beforeChat.subscribe((data) => {     chatrank(data) }) world.events.tick.subscribe((ticks) => {     tick++     if (!world.getDimension("overworld").runCommand('testfor @a').error && !worldLoaded) {         loadTime = tick         worldLoaded = true;         world.getDimension("overworld").runCommand(`tellraw @a {"rawtext":[{"text":"§l§eМир был загружен в ${loadTime} тиках!"}]}`)         world.getDimension("overworld").runCommand(`scoreboard objectives add chatsSent dummy`)     }     if(tick >= 20){         tick = 0         timer()     } })

При заходе в мир будет писать «Мир был загружен в (количество) тиках!». Эти тики означают на сколько быстро был загружен мир или сколько в нём кадров/сек. Иногда это количество 86-194. Такое количество нормальное. А другое — не очень.Также мы импортировали библиотеки timer, world, chatrank.

Слудющий файл — chat.js. Это, пожалуй, самый важный и большой файл, не считая манифеста. Но и без других файлов он не будет работать. Запишем скрипт:

import { world } from "mojang-minecraft"  let messages = new Map()  function chatrank(data){     const tags = data.sender.getTags()     data.sender.runCommand(`scoreboard players add @s chatsSent 0`)     let score = parseInt(data.sender.runCommand(`scoreboard players test @s chatsSent *`).statusMessage.match(/-?\d+/)[0])     let ranks = [];     for(const tag of tags){         if(tag.startsWith('rank:')){             ranks.push(tag.replace('rank:', ''))         }     }     if(ranks.length == 0)ranks = ["§l§aPlayer"]          if(data.message.startsWith("!*")){         data.cancel = true         return     }     if(score >= 3){         data.cancel = true         return world.getDimension("overworld").runCommand(`tellraw "${data.sender.nameTag}" {"rawtext":[{"text":"§l§4Ты пишешь сообщения слишком быстро!"}]}`)     }     if(!messages.get(data.sender.name)){         messages.set(data.sender.name, data.message)     }else {         const oldMsg = messages.get(data.sender.name)         if(oldMsg == data.message){             data.cancel = true             return world.getDimension("overworld").runCommand(`tellraw "${data.sender.nameTag}" {"rawtext":[{"text":"§l§cНе повторяй одни и теже сообщения!"}]}`)         }     }     let text = `§f[${ranks}§r§f] §7${data.sender.nameTag}: §f${data.message}`     world.getDimension('overworld').runCommand(`tellraw @a {"rawtext":[{"translate":${JSON.stringify(text)}}]}`)     messages.set(data.sender.name, data.message)     data.sender.runCommand(`scoreboard players add @s chatsSent 1`)     data.cancel = true } export { chatrank }

Мы импортировали world и экспортировали chatrank. Вы можете изменить некоторые нюансы — сообщения при спаме, Player по умолчанию.

Далее — second.js

import { world } from 'mojang-minecraft' let seconds = 0  export function timer(){     seconds++     if(seconds >= 4){         world.getDimension("overworld").runCommand(`scoreboard players reset * chatsSent`)         world.getDimension("overworld").runCommand(`scoreboard players set "dummy" chatsSent 1`)         seconds = 0         return seconds     } }

Думаю, тут объяснений не надо.

Мы закончили со скриптами и создали все файлы — идём тестировать!

Как это работает?

Всё просто — вы не можете писать одни и теже сообщения, или писать их слишком быстро. Чтобы задать ранг, например ADMIN (по умолчанию Player), нужно использовать эту команду:

/tag @s add rank:РАНГ #вот для красным ADMIN /tag @s add rank:§l§cADMIN

Теперь перед вашим ником будет написанно ADMIN — пусть все знают, кто на сервере босс!

Современные проблемы — требуют современных решений

В нашем аддоне нашлось пару багов. Один из них — кавычка. Если вы попробуете написать подобное сообщение:

Привет, я тут "босс"!

То дополнение не будет работать. Ваше сообщение будет выглядеть вот так:

<nickname> Привет, я тут "босс"!

Но, как говорится, современные проблемы — требуют современных решений. Давайте в chat.js, в команде tellraw изменим кавычки. Вместо «текст» поставим ‘текст’. Если вы на старой версии, вам выдаст синтаксическую ошибку.

Баг2 — проблема с версиями. Если вы не на релизе, а на бета-версии, ваши сообщения будут выглядеть вот так:

command шепчет вам: [Player] nickname: Привет!

Поэтому, ничто не остаётся кроме того как перейти на версию релиза, например, 1.19.11.

Ставим авторские права

Авторские права на аддон можно делать только по желанию, и только если вы его выкладываете публично. Если же аддон был скачан, и в нём были теже авторские права, вы не можете поставить авторские права.

В папке аддона создадим файл — LICENSE.txt или LICENSE.md. Ну, если лицензия короткая, READ_ME.txt. Запишем это:

1. #пункт лицензии 1 2. #и так далее  AntiSpam for my server ©2022  #либо так: #(C) 2022

Конечно, всё что после «#» не используйте. Это комментарий.

На этом всё. Надеюсь, статья была полезной.

ссылка на оригинал статьи https://habr.com/ru/articles/703418/