❔pack.mcmeta overlays FAQ

assets/faqs/pack.mcmeta оверлеи/pack.mcmeta оверлеи.md

@@ -0,0 +1,28 @@
+## {pack_mcmeta} Что такое оверлеи в `pack.mcmeta` и как ими пользоваться?
+Оверлеи, как и фильтры, были добавлены в версии 1.20.2 и позволяют изменять содержимое дп/рп в зависимости от версии, на которой используется этот дп/рп. Таким образом можно сделать например один датапак, который будет работать и на 1.20.5, где предметы до сих пор имеют нбт, и на 1.20.6, где у предметов уже есть компоненты. Учтите, что оверлеи могут только редактировать существующие файлы или добавлять новые к основной папке датапака, удалять они не могут.
+
+### Создаём оверлей
+1. В первую очередь создадим сам физический оверлей — в корневой папке дп/рп создайте папку с любым названием, лучше всего назвать её таким названием, чтоб было понятно, какие версии этот оверлей затрагивает, в этом примере я назову папку `1.20.2-1.20.4`.
+2. Далее внутри новосозданной папки создайте папку `data` или `assets`, в зависимости от того, делаете ли вы дп или рп. создавать файлы `pack.mcmeta` и `pack.png` там не надо, т. к. майнкрафт на них смотреть не будет, он на них смотрит только в корневой папке дп/рп.
+3. Далее можете спокойно внутри этого оверлея добавлять и редактировать файлы, редактировать их можно, если создать внутри папки оверлея файл с таким же названием и по такому же пути, как и в основной папке дп/рп.
+Древо файлов датапака, например, будет выглядеть примерно так:
+<:folder:1142345186949734482> `1.20.2-1.20.4`
+⎿<:data_open:1142345183367802971>`data`
+　⎿<:namespace_open:1188839157829742723>`minecraft`
+　　⎿`...`
+　⎿<:namespace_open:1188839157829742723>`namespace`
+　　⎿`...`
+<:data_open:1142345183367802971>`data`
+⎿<:namespace_open:1188839157829742723>`minecraft`
+　⎿`...`
+⎿<:namespace_open:1188839157829742723>`namespace`
+　⎿`...`
+<:pack_mcmeta:1142345410380304414>`pack.mcmeta`
+<:painting:1142345422233423942>`pack.png`
+---separator---
+4. Остаётся изменить файл `pack.mcmeta`, чтоб указать майнкрафту на существование оверлея. Заходим на [генератор пак мсметы](https://misode.github.io/pack-mcmeta/) от Мизода.
+5. Раскрываем `Overlays`, а далее `Entries`. Каждый добавленный entry — это отдельный оверлей.
+6. В `Formats` выбираем `Exact` если оверлей будет работать только для одного пакформата, `Range (list)` если для нескольких отдельных, и `Range (object)`, если оверлей будет работать во всех пакформатах между какими-то двумя значениями. Для этого примера выберу последний.
+7. В `Min inclusive` пишем пакформат самой старой версии, на которой будет работать этот оверлей, а в `Max inclusive` самую новую версию. Использовав команду </packformat:1203447815305691206>, можно узнать, что на версии 1.20.2 датапаки имеют пакформат `18`, а на версии 1.20.4 — `26`.
+8. В `Directory` пишем название папки оверлея, в нашем случае это `1.20.2-1.20.4`.
+9. Ещё дополнительно в `Supported formats` можно вписать область значений пакформатов, на котором будет работать весь дп/рп, и в этом примере я например сделал так, что дп будет работать на версиях от 1.20.2 до 1.21.2, то я пишу туда пакформаты `18` и `56`. Таким образом дп/рп не будут светиться красным на всех указанных версиях, типа "данный пак не подходит для данной версии". Но учтите, что эта штука также была добавлена в 1.20.2, поэтому в версиях ниже все равно паки будут светиться красным.

assets/links.json

@@ -1,5 +1,5 @@
 {
-	"https://marketplace.visualstudio.com/items?itemName=amandin.dpc-pack": ["Datapack essentials","dpe","dpec","datapack ass entials","datapack extension collection","датапак эссентиалс","датапак экстешон коллекшон","амандин колекшон","вфефзфсл уыыутешфды"],
+	"https://marketplace.visualstudio.com/items?itemName=amandin.dpc-pack": ["Datapack essentials","dpe","dpec","datapack ass entials","dp essentials","datapack extension collection","датапак эссентиалс","датапак экстешон коллекшон","амандин колекшон","вфефзфсл уыыутешфды"],
 	"https://misode.github.io/": ["Misode","Datapack generators","dp generators","ьшыщву","мисод","датапак генераторы","дп генераторы"],
 	"https://mcasset.cloud/": ["mcasset.cloud","mcac","mcassetcloaud","ьсфыыуесдщгв","asset cloud","облако ассетов","мцассетклауд"],
 	"https://maven.blamejared.com/foundry/veil": ["Veil","мушд","веил"],

cogs/faqs/faqs.json

@@ -26,7 +26,7 @@
 	"кастом типы урона": ["custom damage types", "damage types", "dmg type", "типы урона", "дамаг тайпы", "дмг типы", "сгыещь вфьфпу ензуы", "вфьфпу ензуы", "вьп ензу"],
 	"скорборд критерии": ["скорборды", "критерии", "scoreboard criterias", "scoreboards", "criterias", "sbc", "сбс","ыиы","ысщкуищфкв скшеукшфы"],
 	"resolve": ["solve", "ыщдму", "куыщдму", "решено", "ресолв", "резолв", "солв"],
-	"преимущества дп над кб": ["datapacks are better than command blocks","преимущества датапаков над кб","дп лучше чем кб","дп над кб","датапаки лучше чем кб","датапаки над кб","дп>кб","датапаки>командные блоки","datapacks>command blocks","datapacks over command blocks","dp over cb","dp>cb","datapack advantages over command blocks","dp advantages over cb","dp is better than cb"],
+	"преимущества дп над кб": ["datapacks are better than command blocks","преимущества датапаков над кб","дп лучше чем кб","дп над кб","датапаки лучше чем кб","датапаки над кб","дп>кб","датапаки>командные блоки","datapacks>command blocks","datapacks over command blocks","dp over cb","dp>cb","datapack advantages over command blocks","dp advantages over cb","dp is better than cb","преимущества"],
 	"оптимизация селекторов": ["selector optimization","optimize selectors","селекторы @e","оптимизировать селекторы","аргументы селекторов","оптимизировать аргументы селекторов","оптимизировать аргументы","оптиселектор"],
 	"оптимизация NBT": ["nbt optimization","optimize nbt","оптимизация NBT","оптимизировать NBT","нбт оптимизация","NBT оптимизация"],
 	"schedule луп функции": ["цикличные функции с использованием /schedule", "schedule луп функции","луп функции schedule","луп schedule","цикл через schedule","оптимизация функций через schedule","schedule function optimization","optimization with schedule","optischedule","оптискедюл","луп функций скедюл","оптимизация луп функций","скедюл луп"],
@@ -41,5 +41,6 @@
 	"затемнённая текстура в гуи": ["gui_light front", "gui light", "gui front", "front light", "front gui light", "гуи лайт фронт", "гуи лайт", "гуи фронт", "фронт гуи", "передний свет интерфейса", "dark gui texture", "затемнённая текстура в инвентаре","затемнённая модель в гуи"],
 	"inlay hints": ["inlay hint", "hint", "inlay", "инлэй", "инлайн","инлайн подсказки","подсказки инлайн","подсказки внутри команд","inlay hints","hints","инлайны подсказки","подсказки инлайновые","подсказки"],
 	"ПКМ детект": ["right click detect", "rc detect", "rc", "пкм", "пкм детект в дп", "детект пкм", "детект правой кнопки мыши", "дп пкм", "правая кнопка мыши детект", "кс вуеусе", "датапак пкм детект", "методы определения пкм", "райт клик"],
-	"pack.mcmeta фильтры": ["пак мсмета фильтры","фильтры пак мсмета","mcmeta filters","pack.mcmeta filters","мсмета фильтры","фильтры мсметы","фильтры","filters"]
+	"pack.mcmeta фильтры": ["пак мсмета фильтры","фильтры пак мсмета","mcmeta filters","pack.mcmeta filters","мсмета фильтры","фильтры мсметы","фильтры","filters"],
+	"pack.mcmeta оверлеи": ["pack.mcmeta overlays","mcmeta overlays","pack.mcmeta оверлеи","mcmeta оверлеи","оверлеи пак мсмета","overlays","оверлеи","пакмсмета оверлеи"]
 }