Introduce

• Изначально данный проект был сборником библиотеком, который перерос в автоматическую загрузку скриптов, а там и в архитектуру. И я использовал данную платформу для всех своих проектов (аддонов, сборок). На момент 10.11.23, разработка платформы заморожена. Я очень надеюсь, всё же кому то, кроме меня, она поможет в разработке под Garry's Mod. Вот список некоторых особенностей, которые уже есть или которые я реализую в этом проекте или в последующих:

• Репозиторий будет на английском, как и документация
• Сама дока - слабое место этого проекта. В октябре 2023 раздумывал о автоматической публикации через md, нужен свой парсер.
• Есть синтаксический сахар: ePly:GetNWInt("Money") == ePly.nw_Money
• Есть поддержка пустых файлов с префиксом wid_xxxxxx, работает и просто в addons, парсит первую папку аддона.
• Есть особый ChatSend по правилу одной строки

  ePly:ChatSend( "~WHITE~ Example #example_language" )

• Планировался мощный UI Kit - Tyrex в виде модуля
• Модули должны были полностью сепаратированы в отдельную репу

Я очень благодарен Ambi Eco, и что решился на этот важный шаг. На 6 месяце обучения (Ноябрь 2020) пошёл на два важные принципа программирования: автоматизация и систематизация, начал заниматься архитектурой. Сейчас же я иду дальше, а именно в Unity и s&box, и буду иногда возвращаться в гмод, и может даже обновлять Ambi Eco.

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

Info

• Version: 6.6
• Team: Ambi
• Language: GLua (Lua)
• Game: Garry's Mod

What is it

Ambi Eco – это платформа по разработке аддонов для серверов в игре Garry's mod. Данный проект даёт возможность осуществить грамотное управление сервером и добавление модулей.

How to setup?

1. Скачайте архив с этого репозитория (Синяя кнопка Code --> Download ZIP)
2. Папку ambi распакуйте в addons
3. Всё 😄

• Более подробный гайд на Официальной Вики

Features

• Экосистема пригодна только для серверов в игре Garry's Mod.
• Основной язык GLua - диалект Lua.
• Можно загружать и просто аддоны на сервере, где есть такая экосистема, они не буду конфликтовать.
• Не путайте с module() в Lua, здесь внутренние аддоны называются Модулями.
• Документация по библиотекам и модулям.
• Своя загрузка модулей и полный контроль над ними.
• Большое количество разных библиотек, в том числе и интеграция из чужих библиотек.
• Стандартная библиотека general.
• Модули и Библиотеки:
  • Большинство модулей можно отключить или удалить, библиотеки не стоит отключать без необходимости, тем более, не стоит это делать со стандартной библиотекой.
  • Модуль более специфичный для сервера, когда библиотека общая для всех.
  • Модуль может только использовать инструменты, и создавать специфичные, когда библиотека обязательно должна сгенерировать инструментарий.
  • Библиотеки не имеют право использовать функционал друг друга, кроме использования стандартной библиотеки, модули могут быть связаны друг с другом.
  • Локализация стандартных классов и функций (local string = string) чаще всего происходит в библиотеках, когда модулям лучше не перебарщивать с ними.
  • Модули, в которых таблицы будут названы, как таблицы библиотек: General, UI и т.д. Не будут загружены.

Convention of Style

1. Функция обозначается с Upper CamelCase: Class.ToMake()
2. Константа (переменные, таблицы) обозначается змеиной нотаций с верхним регистром: ALL_NUMBERS = 3.1415
3. Локальная переменная/таблица обозначается змеиной нотаций с нижним регистром: local result = nil
4. Класс обозначается с Upper CamelCase: Class.ChildClass.ChildChildClass = setmetatable( {}, ParentClass )
5. Между операндами желательно ставить пробелы: 2 + 2
6. Одиночные операций не обозначаются скобками: IsValid(a)/not IsValid(a), все остальные операций:( GetSize( a ) == false )
7. В модулях допускается свой собственный стиль, который задумал автор модуля.

Libraries

1. General — стандартная библиотека, имеет в себе набор необходимых методов для работы с другими библиотеками и модулями. В ней также есть утилиты для разработчиков и глобальные константы. Здесь имеются классы: string, math, util и т.д
2. UI — большой пакет клиентского интерфейса, содержащий всё для редактирования client-side (GUI, шрифты, звуки и так далее).
3. SQL — библиотека для удобного использования SQL.
4. RegEntity — регистрация и контроль новых entities (npcs, weapons). Есть создание tools.
5. Cache — система кеширования различной информаций.
6. Files — библиотека для удобного взаимодействия с файлами/папками.
7. NW — библиотека для удобного использования SetNW/GetNW для Entities.
8. Download — серверный контроль над resource.AddFile(); resource.AddWorkshop() и resource.AddSingleFile(). Взаимодействие с коллекцией.
9. HTTP — для работы с HTTP-requests, а именно GET и POST, логирование запросов. Поддержка CHTTP
10. Player — контроль над классом Player, совместим со всеми методами из оригинального класса.
11. Entity — контроль над классом Entity, совместим со всеми методами из оригинального класса.
12. Timer — контроль над классом timer, совместим со всеми методами из оригинального класса.
13. Packages — возможности быстрой распаковки данных в таблицу из библиотеки (например, быстро коротко распаковать Ambi.General.Global.Colors в таблицу C)
14. SaveData — упрощенная система по работе с перманентными данными
15. JSON - набор методов по работе с JSON.

Important Links

• Documentation

• Roadmap

• Ambi Steam

• Ambi VK

• Ambi Discord

• Ambi Market

• dash - библиотека, частично которую я интегрировал

• GMStranded - режим, утилиты которой я интегрировал

• Lua AES - AES, которую я интегрировал

• TDLib - GUI

• DLib

Modules

• Новый DarkRP