Избранное ASI SAMPFUNCS

[FYP]

Версия SA-MP

1. 0.3.7 (R1)
2. 0.3.7-R3
3. 0.3.7-R5
4. 0.3DL

SAMPFUNCS​

Актуальная версия - 5.7.1 (SA-MP 0.3.7-R1; SA-MP 0.3.7-R3-1; SA-MP 0.3.7-R5; SA-MP 0.3.DL)

SAMPFUNCS это дополнение к библиотеке CLEO 4, глобально расширяющее возможности скриптинга. Его основной целью является помощь в осуществлении различных задач в моддинге игры GTA San Andreas и мультиплеерной модификации San Andreas Multiplayer (SA-MP).
Продолжение и вся остальная информация находится здесь: https://blast.hk/wiki/sampfuncs:start
История изменений: https://blast.hk/wiki/sampfuncs:changes_history

Установка:
Скачайте архив "SAMPFUNCS-5.7.1.zip" и скопируйте файл "SAMPFUNCS.asi" соответствующей версии SA-MP из архива в корневую папку игры.

Спойлер: SDK

Для разработки CLEO скриптов:
Из директории "sanny-builder" в архиве SAMPFUNCS-SDK.zip скопируйте содержимое папки "v***" для соответствующей версии Sanny Builder в корневую папку с установленной программой.
В новых версиях Sanny Builder в коде CLEO скрипта должна присутствовать директива {$USE SAMPFUNCS} для компиляции с опкодами SAMPFUNCS. В Sanny Builder 3.9.0 и новее помимо этого ещё должен быть выбран режим редактирования "GTA SA v1.0 (SAMPFUNCS)".
Для разработки SF плагинов:
Архив SAMPFUNCS-SDK.zip содержит установщик шаблона проекта SF-плагина для Visual Studio и шаблон проекта для CMake.
Отдельная тема о SF API - https://blast.hk/threads/6498/

Благодарности:
Выражаю особую благодарность @legend2360 за работу над CLEO Wiki и всей команде BlastHack в целом за помощь в разработке и тестировании.
Большое спасибо команде MTA за их огромную работу над GTA San Andreas и общедоступный Game SDK.

Внимание!
SF-плагины с версии 5.0 до 5.1.1 не совместимы с 5.2 и выше.

Если плагин не работает, выдавая ошибку при запуске игры, попробуйте сделать следующее:
1. Убедитесь что у вас не установлена любая другая версия SAMPFUNCS (удалите если есть).
2. Переустановите CLEO 4 CLEO Library^{(http://cleo.li/)}
3. Замените gta_sa.exe на стандартный gta_sa.exe v1.0 US
4. Установите совместимый клиент SA-MP

Что делать если вылетает игра, хотя все требования учтены?
1. Убедитесь, что проблему вызывает именно SAMPFUNCS
2. Проверьте SAMPFUNCS на работоспособность без всех скриптов, asi и sf плагинов.
2.1. Если SAMPFUNCS работает без них, постарайтесь выяснить что за мод вызывает проблему и обратитесь за помощью к разработчику мода.
3. В случае если ничего не решилось - опишите проблему в этой теме и прикрепите файл "sampfuncs.log" (находится в папке SAMPFUNCS в корне игры).

Спойлер: F.A.Q.

Q: Как установить SAMPFUNCS?
A: Файл SAMPFUNCS.asi копируем из архива в папку с игрой.

Q: Что требуется для работы SAMPFUNCS?
A: Для работы SAMPFUNCS необходимо следующее:

1. Рабочая копия игры GTA San Andreas
2. gta_sa.exe v1.0US
3. ASI Loader
4. CLEO 4.1 или выше
5. Клиент SA-MP соответствующей версии

Q: Где находится папка "SAMPFUNCS"?
A: В корневой папке игры.

Q: Что делать если нет папки "SAMPFUNCS"?
A: Создать её вручную или запустить игру с SAMPFUNCS, тогда папка создастся автоматически.

Q: У меня нет папки "SAMPFUNCS" и она не появляется даже после запуска игры.
A: У вас включена защита UAC в Windows. Чтобы её отключить вам надо: Зайти в Панель управления > Учетные записи пользователей > Изменить параметры контроля учётных записей и переместить ползунок в самый низ > сохранить. Другая возможная причина - игра установлена в одну из системных директорий, где нет прав на запись (зачастую это 'Program Files'), в этом случае переустановите игру в другое место.

Q: У меня вылетает игра, хотя она чистая.
A: Список возможных решений проблем с вылетами:

• Установите DirectX 9 и Microsoft Visual C++ Redistributable
• Убедитесь, что версия SA-MP совместима с SAMPFUNCS.
• Попробуйте в файле sampfuncs-settings.ini задать следующие настройки:

multiprocess = false​

antipause = false​

exception-handler = false​

• Несмотря на то, что в SAMPFUNCS есть поддержка Windows XP, рекомендуется обновить свою версию Windows до более новой.
• Проверить установленные моды на несовместимость с SAMPFUNCS и в случае обнаружения устранить конфликты.

Q: При открытии меню игры всё мерцает...
A: Измените в настройках параметр draw-info-bar на "false".

Q: Где находится файл настроек sampfuncs-settings.ini"?
A: В папке SAMPFUNCS.

Q: С какими модами SAMPFUNCS несовместим?
A: NewOpcodes от DK22Pac - несовместимость опкодов.

Q: Совместимы ли новые версии SAMPFUNCS со старыми версиями SA-MP 0.3?
A: Не совместимы.

Q: Что за папка "SAMPFUNCS SDK" в архиве? Что с ней делать?
A: Этот архив содержит файлы для разработки CLEO-скриптов и SF-плагинов. Если вы не собираетесь ничего разрабатывать, просто забудьте про него.

Q: Как установить .SF плагин?
A: Следуйте инструкции по установке (если есть) или просто скопируйте файлы мода в папку "SAMPFUNCS".

Q: Мой антивирус помечает SAMPFUNCS как вредоносный и даже удаляет его.
A: Антивирусные программы зачастую определяют софт такого рода как вредоносный, поскольку основная работа приложений этого типа осуществляется с помощью прямого доступа к памяти процесса. Помимо этого, в прошлых версиях SAMPFUNCS была встроена проверка обновлений и он был сжат упаковщиком для уменьшения размера, поэтому большинство антивирусов относится к нему с подозрением. Для предотвращения удаления SAMPFUNCS антивирусом, добавьте его в список исключений антивируса.

Q: Где найти подробную информацию, описание опкодов, список изменений, уроки связанные с SAMPFUNCS?
A: Здесь: https://blast.hk/wiki/

Q: Как исправить: "WARNING! CLEO couldn't register opcode handler"?
A: Возможно у вас установлены две версии SAMPFUNCS или плагин NewOpcodes.cleo. Удалите их.

Q: Совместим ли SAMPFUNCS с mod_sa (s0beit)?
A: С оригинальной версией совместим полностью.

 

[Dark_Knight]

Самый первый вопрос в теме. Когда обнова? А то некоторые опкоды криво работаю или даже не работают.

 

[GreatGreen]

Без него уже нечего не делается )

 

[Dark_Knight]

Пилиииииииии обнову :crazy:

 

[Rafael]

Пилиииииииии обнову :crazy:

Cюрприз же :trollface:

Gta_Sa.EXE US v1.0

 

[Jack]

FYP как обычно

 

[botiQ#]

Alex,ошибка при нажатии

 

[Dark_Knight]

Нету пока такого окпода.

 

[FYP]

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

:facepalm:

тебе стоит прочесть правила.

 

[Dark_Knight]

Опкод для проверки типа подключения к серверу.

 

[Dark_Knight]

Опкоды

0B39: samp get_current_server_address 0@ port 1@
0B3A: samp 0@ = get_current_server_name

Не правильно отображают инфу. Пример:

0B39: samp get_current_server_address 10@ port 11@
0B3A: samp 12@v = get_current_server_name
0B2B: samp 13@ = get_player_id_by_actor_handle $player_actor
0B36: samp 14@ = get_player_nickname 13@
0D2D: get_local_time_year_to YEAR month_to MONTH day_of_week_to DAY_OF_WEEK day_to DAY hour_to HOUR minute_to MINUTE second_to SECOND milliseconds_to MILISECOND
0AD9: write_formatted_text "[%02d:%02d:%02d] Игрок %s(id %d)подключилься к %s%c" in_file 9@ HOUR MINUTE SECOND 14@ 13@ 12@v 10
0AD9: write_formatted_text "[%02d:%02d:%02d] Адресс сервера %d порт %d %c" in_file 9@ HOUR MINUTE SECOND 10@ 11@ 10
0A9B: closefile 9@

И в файл записываються не верные данные.

[15:00:36] Игрок MindFreak(id0)подключилься к Иљ
Рљ
2048MB- 
[15:00:36] Адресс сервера 0 порт 0

 

[FYP]

MindFreak, неправильно используешь. надо так:

0AC8: 0@ = allocate_memory_size 32
0AC8: 1@ = allocate_memory_size 256
0B39: samp get_current_server_address 0@ port 2@
0B3A: samp 1@ = get_current_server_name
0AD9: write_formatted_text "Server %s Address %s:%d" in_file 9@ 1@ 0@ 2@

 

[FYP]

Обновлено до версии 2.4!

 

[MogAika]

Отдельное спасибо MogAika и MISTER_GONWIK за помощь в разработке и тестировании. А так же MindFreak за спонсирование проекта.

Самое главное же

 

[Dark_Knight]

Кстати, ты в описание не все опкоды добавил :D

Самое главное же

Вот тут не поспоришь :D