Учебник PAWN RU
From SA-MP Wiki
Contents |
Учебник PAWN
- СТРАНИЦА НАХОДИТСЯ НА СТАДИИ ПЕРЕВОДА
Делаем простой deathmatch
Сделать простой deatchmatch на PAWN не может быть проще. Просто откройте Pawno (смотрите Редакторы скриптов) и нажмите "new". Вот он, ваш первый скрипт. Чтобы запустить его сначала сохраните. Большинство людей сохраняют его в "<Директория установки GTA: San Andreas>/gamemodes/src/", но для локального тестирования легче сохранить в "<SA>/gamemodes/"), и затем нажать на кнопку в панели инструментов левее кнопки с изображённой синей стрелкой. Это скомпилирует ваш .pwn файл в .amx в тот же каталог, хотя чтобы игра видела его необходимо чтобы он был в "<SA>/gamemodes/". Теперь, чтобы протестировать ваш скрипт, вам понадобится создать локальный сервер и поменять на ваш режим (наберите "changemode <название вашего режима>" в окне сервера).
Если всё правильно, то когда вы присоединитесь к своему серверу через клиент SA:MP и начнётся игра, вы должны появиться около казино в Лас Вентурасе. К сожалению, вы не сможете увидеть меню выбора персонажей (сейчас всего только один), но мы можем с лёгкостью изменить это потом. Также это не очень интересный deathmatch из-за отсутствия противников.
Классы
Теперь первая вещь, которую вы, наверное, хотели бы добавить это раздачу оружия по классовому принципу. Каждый персонаж называется "классом". У всех могут быть одинаковое или разное оружие или смесь. Вы выставляете параметры для каждого класса отдельно, поэтому чтобы поставить одинаковое оружие для каждого класса, просто скопируйте параметры оружия и вставьте в параметры каждого класса. Это обеспечит сбалансированный deathmatch, но зато будет не так интересно, так что решать вам. В редакторе найдите эту строку:
AddPlayerClass(0, 1958.3783, 1343.1572, 15.3746, 269.1425, 0, 0, 0, 0, 0, 0);
Это параметры класса, следуют они в таком порядке:
AddPlayerClass(Модель игрока, X, Y, Z, Направление, Оружие 0, Боеприпасы 0, Оружие 1, Боеприпасы 1, Оружие 2, Боеприпасы 2);
Модель игрока можно взять из файла "peds.ide", "X", "Y" and "Z" - координаты точки возрождения, "направление" - направление куда лицом смотрит персонаж. Номера оружия можно найти ниже, а номера боеприпасов - просто количество боеприпасов на оружие которое вы хотите им давать при возрождении (Количество боеприпасов оружия ближнего боя всегда должно равняться 0).
Теперь скопируйте эту строку:
AddPlayerClass(102, 1958.3783, 1343.1572, 15.3746, 269.1425, 5, 0, 22, 100, 32, 50);
и поместите её под той, которую вы нашли в скрипте. Теперь вы будете выбирать между СиДжеем с пустыми руками и Балласовцем с бейсбольной битой, пистолетом и Тек9.
Получение координат, направлений и id моделей
Вы наверняка захотите добавить дополнительные точки возрождения, поскольку если все будут появляться в одном и том же месте, то deathmatch будет скучным и кемпинг будет невероятно лёгким. Здесь в игру вступает режим отладки. Запустите "samp_debug.exe", находящийся в корневой директории San Andreas. После того как запустится режим отладки, дойдите до той позиции, где вы хотите сделать точку возрождения и напечатайте "/save" в окне чата (чтобы вызвать окно чата нажмите "t" или тильду (~)). Эта команда сохранит ваше местоположение, направление и id модели игрока в текстовый файл "savedpositions.txt" в корневой директории SA.
Знакомство с функциями и вызываемыми функциями
Before we can continue you will need to be introduced to callbacks. These are the chunks of code already in your gamemode that look something like this:
public OnPlayerDisconnect(playerid)
{
printf("OnPlayerDisconnect(%d)", playerid);
return 1;
}
This is the OnPlayerDisconnect callback, that means this section of code is run by the server whenever a player disconnects, so if you want to show a big message on the screen when a player leaves you would put the code for that here. All the callbacks the game uses (except 2, but they are used by filterscripts, not gamemodes and are not covered here) are in your file, you cannot make up your own. Most of them appear as the one above does, but some (i.e. "OnPlayerCommandText", "OnPlayerRequestClass", "OnGameModeInit" and "main" (which is not strictly a callback and never has more than your game title)) have other bits in already, either to make the game work or to show you what to do there. You may also use other, similar blocks (as we are about to) which look the same but are called functions, these have to be called by you yourself. Here is a function called "IMadeThis" (note the lack of spaces).
public IMadeThis() { // This is a comment and is ignored by the game/compiler /* So is this */ print("This will be printed to the server window"); return 0; }
You may have also noticed a very quick introduction to comments there, everything on a line after "//" will be ignored, as will anything anywhere between "/*" and "*/". As a function is not called by the game we need to call it ourselves from a callback, this is dead easy as most of the commands you use to code with are infact premade functions (commands are infact different), so if you placed:
IMadeThis();
in your OnPlayerDisconnect callback (it must be between the "{" and "}" and also before the "return 1;" it would run that function and print a message in the server window when you disconnected (remember the othr things in there are ignored). We don't generally want to print things to the server window and all the "print" and "printf" functions already in the file are generally removed by the coder. Only things between the braces are in the function/callback (from now on function refers to callbacks aswell as they are a special case of function), the line above is the name of the function. "public" means the function can be run by any other bit of code, this basically means your code can be run when you call it, we're not worried about private functions as they are not generally used in SA-MP (if at all). The brackets after the function name enclose the parameters list, we haven't covered these yet but you can see an example of their usage in some of the callbacks in your blank file, note that those parameters are automatically passed when the game calls the function, if we are using a custom functions (i.e. not a callback) and we want to use some parameters we will need to pass them ourselves. One tiny other thing which should be mentioned is that all lines apart from lines with braces on (and even them in certain circumstances, but these will be covered later) and lines directly before an open brace (braces may be on the end of that line or, as shown here, on a new line), end with a semicolon to denote the end of a process.
Делаем командный deathmatch
OK, now you know how to make classes and place them about we will show you how to set teams, this will be the first bit of real coding but is fairly easy. I will just be using the two classes described on this page so if you have more remove them for now or start a new mode and make sure only those two are in. Classes are numbered in order from 0, so the first class in your file is 0, the second is 1 and so on (computers and programs nearly always start from 0 in counting (you will find that your playerid in a test game is 0)). We want to set the team based on which class they choose (either Grove or Balla), you may look at the callbacks and think that this would go in the OnPlayerRequestClass function, and you would be correct. When the select their class you want to set the team based on that, we can't do it in the OnPlayerSpawn function as at that point we don't know the class they have selected (that is a parameter and only parameters we are passed or which are global in your script (we will cover this later) can be used in any function). First we need to define our teams, under the "#include" line(s) at the top of your file add these lines:
#define TEAM_GROVE 1 #define TEAM_BALLA 2 #define TEAM_GROVE_COLOR 0x00FF00AA // Bright Green (in RGBA format) #define TEAM_BALLA_COLOR 0xFF00FFAA // Bright Purple
If you want to alter the colors, that's fine, just remember that the last two digits are the alpha and the lower that is the less you can see the color. Defines are purely replacements, now if you ever want to use the number 1 in your script you can use TEAM_GROVE instead, this is not a good idea for normal calculations as it makes them harder to read, but for using to denote teams, which are only denoted by a number, it makes it alot clearer what's going on (and makes it very easy to change the teams around or modify later as you need only change the 1 in the define rather than all the instances of it throughout the code. When the code is compiled, all the "TEAM_GROVE"s will be replaced by 1, it is not like a variable, it is a constant, it doesn't change. Now under those lines add:
new gTeam[MAX_PLAYERS];
This is called a global array. An array is basically lots of variables (places you store data to read and write) clumped together to store lots of data at once. The "MAX_PLAYERS" is a pre-defined constant (done in exactly the same way as we did our defines. MAX_PLAYERS is actually set at 100, so this means that our array can store up to 100 pieces of data. The g on the name means global, but that doesn't make it global (it just makes it easier to tell what variables do what, defining it outside a function means it is global and can be used by all our functions. Any variable defined in a function is local to that function and it cann't have the same name as another variable in the same function or a global variable (which is also why the g is useful), it can however have the same name as another variable in another function. All the "playerid" variables in your blank script are infact all independent variables, each local to a different function, however they are all passed the same data, but just remember that any functions you make won't auomatically have that data. Now we have that set up we can set the teams:
public SetPlayerTeamFromClass(playerid, classid) { if (classid == 0) { gTeam[playerid] = TEAM_GROVE; } else { gTeam[playerid] = TEAM_BALLA; } }
Place that code OUTSIDE a function in your code (as it is a new function) and put these lines as the first things after the open curly braces in your OnPlayerRequestClass callback (notice the way the variables are not global so we are having to pass them to out function too):
SetPlayerTeamFromClass(playerid, classid);
This will save the players team to an array through our new function. Data in an array is referenced by a number, so array[0] is the first item of data, array[1] is the second and so on, as we are using gTeam[playerid], depending on which playerid we are passed will define where in the array to store the data, so for player 5 their data will be stored at array position 5 (remember, this is the 6th piece of data). Now copy this function:
public SetPlayerToTeamColor(playerid) { if (gTeam[playerid] == TEAM_GROVE) { SetPlayerColor(playerid, TEAM_GROVE_COLOR); } else if (gTeam[playerid] == TEAM_BALLA) { SetPlayerColor(playerid, TEAM_BALLA_COLOR); } }
And add the following line to OnPlayerSpawn:
SetPlayerToTeamColor(playerid);
We now have our teams, but what have we actually done?
if (classid == 0) { gTeam[playerid] = TEAM_GROVE; }
In our first function, we check which class they chose (remember we said that the first class defined in your file was class 0?) "==" means "is equal to", a single equals sign simply sets the variable to the number given (as seen on the next line but one). The curly braces sepparate the functions between them from the rest of the code, bits in there are only executed if the selected class is 0 (cj), if it isn't, the else command comes into play and executes insted (this executes whenever the "if" command is false (i.e. the class isn't 0)), since we only have two classes to choose from this must mean we're Balla:
else { gTeam[playerid] = TEAM_BALLA; }
We don't need a return here as there is no data to return.
The second half set the players' color when they spawn, so you can tell who's on which team. As we saved their team to a global array, we can still access the data even though it is in a separate function.
if (gTeam[playerid] == TEAM_GROVE) { SetPlayerColor(playerid, TEAM_GROVE_COLOR); }
Hopefully you can see what this is doing now, if the player who just spawned (as referenced by playerid) is in TEAM_GROVE, we set their color to TEAM_GROVEs color.
else if (gTeam[playerid] == TEAM_BALLA) { SetPlayerColor(playerid, TEAM_BALLA_COLOR); }
This next section is a little different, it could easilly have been done like this:
else { SetPlayerColor(playerid, TEAM_BALLA_COLOR); }
But the way it is done allows you to set their color to TEAM_BALLAs color only if the first part is false (as sorted by the ELSE) AND if they are in TEAM_BALLA, this allows you to add more options by adding more "else if ()" blocks to the end as one will only be executed if all the blocks before it weren't.
Транспорт
Хорошо. Если вы читали предыдущие разделы, то у вас уже должен быть очень простой deathmatch или командный deathmatch с расставленными точками возрождения где вы хотите. Теперь давайте добавим транспорт. Большинство команд на PAWN делают именно то как они называются. Мы же хотим добавить транспорт, так давайте поищем нужные команды:
CreateVehicle();
AddStaticVehicle();
Если вы нажмёте на одну из них и посмотрите в статус окно (окно внизу редактора), вы увидите их синтаксис (какую информацию\параметры вам требуется дать для их работы):
[a_samp.inc] native CreateVehicle(vehicletype, Float:x, Float:y, Float:z, Float:rotation, color1, color2);
[a_samp.inc] native AddStaticVehicle(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2);
Они очень похожи друг на друга, но вот здесь важно знать одну вещь: CreateVehicle создает авто ОДИН раз, а AddStaticVehicle создаёт точку возрождения данного авто. Они должны выполняться с начала игры, поэтому их следует поместить в вызываемую функцию "OnGameModeInit()".
Значения modelid/vehicletype можно найти в файле vehicles.ide, числа с плавающей запятой - просто не целые числа, обычно координаты и направления. Номера цветов можно найти в файле carcols.dat, посмотрите на сноску и выберите цвет, который хотите. Так "black" это "0", "taxi yellow" это "6", "currant blue poly" это "32" и т.д., "-1" означает случайный цвет (из базовых цветов этой машины, которые хранятся в файле carcols.dat). Если вы хотите получить позицию для будущей машины, войдите в debug-режим, выберите машину, войдите в нее и напишите "/save", после этого откройте файл "savedpositions.txt" и копируйте линию. Если вы хотите добавить машину в режиме отладки (debug-mode), напишите "/v <vehicleid>" во время игры и машина появится (id машины берется опять же из vehicles.ide), или напишите "/vsel" для вывода списка машин с их id.
Я получил такие координаты:
2040.2279, 1344.4127, 11.0, 3.5436
Note: These are called floats, 11.0 is a float despite being whole, any whole number being used as a float must have a trailing ".0" to denote it as a float. These numbers are in the english format of using a decimal point ("."), commas are used to separate parameters. Also remember the 4th number is angle, so if we now add the following line to the game mode in OnGameModeInit, recompile and test, we will get a bright pink infernus outside the casio which is the default spawn position for cj. Note: on a car which uses the secondary color (such as a cop car (id 596)) this would be a pink and blue car as that is the secondary color.
AddStaticVehicle(411, 2040.2279, 1344.4127, 10.6719, 3.5436, 126, 54);
Now you can easilly go about saving positions and creating as many cars as you want (up to an engine defined limit of 254 individual cars, 50 different types of car). The spawns saved to the file will have "-1, -1" as the colors by default.
Ограничение игрового мира
А что, если нужно, чтобы игра происходила на определённой территории? В этом случае прибегнем к функции SetPlayerWorldBounds и, для начала, посмотрим её синтаксис:
SetPlayerWorldBounds(playerid,Float:x_max,Float:x_min,Float:y_max,Float:y_min)
Где "playerid" - ID игрока, "Float:x_max", "Float:x_min" - максимальные и минимальные x-координаты куда игрок может попасть, а "Float:y_max" и "Float:y_min" - максимальные и минимальные y-координаты куда игрок может попасть.
Пора опробовать эту функцию на деле. Вставим эту функцию в вызываемую функцию OnPlayerSpawn:
public OnPlayerSpawn(playerid) { SetPlayerWorldBounds(playerid,1994.9497,1839.3379,-1333.2124,-1472.2440); return 1; }
И, наконец, скомпилируем функцию. Теперь вы можете прокатиться на велосипеде в пределах парка с рампами в Лос Сантосе.
