Buscar en la comunidad

Esta es la lista ORDENADA de los puntos a leer en este tutorial, favor de seguir el orden correspondiente para su correcto entendimiento: Comentarios : ayuda a las personas a que entiendan tu codigo (o tambien te ayuda a vos) Variables : como guardar datos Arrays y Strings : como guardar datos multiples, palabras y frases Funciones : creando nuestras funciones Natives : usando funciones ya creadas Forwards : obtener informacion o realizar cierta accion cuando algo ocurre Estructura : ejemplo de estructura de un plugin Algunos Tips : unos pequeños tips que te serviran a la hora de empezar Otras Ayudas : una lista de guias y tutoriales que te van a servir para seguir aprendiendo Nota: Tengan en cuenta que lo mostrado en este thread son solo ejemplos, algunos posiblemente no funcionen si los copian y pegan, esto es principalmente para aprender de que forma se hacen ciertas cosas dentro del AMXX Scripting. Primero, podriamos asociar a un plugin como si fuera una bodega. En la bodega encontramos cajas (se podrian considerar VARIABLES), tambien maquinas (se podrian considerar funciones), carga y recibo de mercaderia (forwards y returns), y puertas que nos conectan hacia otras bodegas (natives). * Claro que deben hacer de cuenta que esto se parece a una bodega /guiño Comentarios Una de las primeras cosas que debes saber sobre el codeo de plugins (aunque se podria decir sobre la programacion en general), es el uso de COMENTARIOS. Los comentarios sirven para agregar diferentes notaciones al codigo del plugin, lo cual ayuda a que los demas puedan entender diferentes cosas de TU codigo o aclarar algunas partes, o incluso para hacer un tutorial mostrando codigo. Aunque no solamente sirve para ayudar a otros, tambien puede que te sirva tener tus propias anotaciones para uso personal. Los comentarios pueden ir en cualquier parte del codigo, no tienen un lugar obligatorio. Cabe aclarar tambien, que solo sirve para la lectura del codigo, no para otra cosa... el compilador no lee ni compila ningun comentario. Ejemplo: Un comentario equivalente expresado en codigo seria asi: // PELIGRO: Michael Jackson paso por aca, no deje a sus hijos sueltos Y obviamente podemos agregarle mas informacion y mas comentarios: / / PELIGRO: Michael Jackson paso por aca, no deje a sus hijos sueltos // Pero despues del 25 de Junio de 2009, ya no nos tenemos que preocupar mas por eso Otro uso de comentarios es que uno puede agregar ciertas anotaciones para luego no olvidarse de agregar algo al codigo, o algo similar. Tambien se usan mucho los comentarios para agregar informacion del plugin (descripcion, cvars, comandos, historial de versiones, etc), pero esto se detallara mas adelante. Cada lenguaje de programacion tiene diferentes tipos de comentarios, o diferentes formas de realizarlo, en PAWN tenemos 2 tipos: Comentario de una sola linea Comentario de multiples lineas El Comentario de una sola linea comienza con // y todo lo siguiente a // es ignorado por el compilador. Puede ser usado al principio de una linea o en el medio: // Esto es correcto codigo aqui // esto tambien es correcto El Comentario de multiples lineas comienza con /* y termina con */. Todo lo que se encuentra dentro de estos 2 es ignorado, por lo tanto se puede comentar varias lineas de una forma mas practica que el otro tipo de comentario. /* Este tipo de comentario tambien puede ser usado en una sola linea */ /* O tambien puede ser usado en multiples lineas, en este caso se le da un mejor uso */ /* Y tambien puede ser usado de esta forma */ Variables Ahora entrando mas en lo que es el codigo (que si va a ser compilado). Nos encontramos con una de las cosas principales y mas usadas, las variables. Que seguramente las hayan visto en matematica, cuando hablamos de X, de como X puede representar un numero. En el codigo, una variable puede ser representado como si fuera una caja: Una caja en la que le podemos asignar un valor, o mejor dicho guardar un valor dentro de esa caja (pero esto se mostrara despues). Para crear una variable, debemos hacerlo de la siguiente manera: new nombre_de_variable Podemos utilizar el nombre que querramos, aunque siempre es conveniente usar un nombre que representa lo que vamos a guardar adentro de esa variable. Recuerden tambien que el nombre de la variable no puede comenzar con un numero, pero si puede contenerlos en el nombre, tampoco puede llevar ningun caracter raro, excepto el guion bajo "_". Y tampoco puede llevar espacios, para eso se usa el guion bajo mayormente. Como dijimos, el nombre de la variable tiene que ser acorde a lo que vamos a guardar dentro de ella, por lo tanto en este ejemplo vamos a usar esta variable para guardar la cantidad de manzanas que tenemos: El nombre de la variable, no tiene que ser obligatoriamente la representacion del uso que le vamos a dar, pero si es recomendable hacerlo para que se entienda el codigo, para que nosotros nos entendamos y tambien que nos puedan entender. Es ilogico ponerle el nombre a una variable como "manzanas" cuando en realidad vamos a guardar la cantidad de alfajores que tenemos, por ejemplo. Tengan en cuenta que al crear una nueva variable, si al momento de crearla no le asignamos ningun valor, por defecto esa variable va a contener el valor 0. Y luego podemos cambiar el valor de esa variable al numero que nosotros queramos, de la siguiente forma: nombre_de_variable = 3 Entonces lo que hacemos es cambiar el numero inicial 0 al 3 y el resultado seria este: Tambien deben saber que pueden crear la variable y asignarle un numero al momento de crearla, por lo que en ningun momenot esa variable contendra el valor de 0. Un ejemplo: new manzanas = 5 Sepan tambien que el signo igual (=) es usado para asignar (o cambiar) valores. En cambio el signo igual igual (==) es usado para comparar (o chequear) valores. Una variable siempre va a ser usada para contener un numero, y a su vez se puede ir modificando dependiendo el uso que le demos y tambien podemos usar operadores matematicos. Como por ejemplo: new manzanas = 5 + 3 Entonces la variable manzanas va a contener el valor 8. Tambien, dependiendo el uso que le den y las distintas variables que usen dentro de su codigo, pueden hacer algo como esto: new manzanas_mias = 5 new manzanas_de_pepe = 7 new resultado = manzanas_mias + manzanas_de_pepe // 5 + 7 Entonces luego de eso la variable resultado va el valor de la suma entre las otras dos variables, lo que va a dar un valor de 12. Espero que les halla servido, CREDITOS A ALUCARD DE ALLIED MODDERS

Bueno, esto es una traduccion de Alucard^ de este tutorial (en ingles): http://forums.alliedmods.net/showthread.php?t=91207 hecho por joaquim... da un breve comienzo a la programacion (pawn) antes de entrar en lo que es la programacion en AMXX. En la programacion, todo esta representado por numeros. Una letra es un numero, una palabra es un grupo de numeros, un color es un grupo de 3 numeros (RGB = Red, Green, Blue = Rojo, Verde, Azul). Entonces para programar hay que tratar con numeros. PARTE 1 - Variables, Numeros y Numeros de Arrays Para poder guardar un numero, tenemos que buscar el lugar donde guardarlo... y ese lugar es denominado variable. Hacemos lo siguiente: new NombreVariable * new significa que estamos creando una nueva variable. * NombreVariable es el nombre que le asignamos a la variable que creamos. * Le podemos poner cualquier nombre, pero siempre es conveniente usar el nombre mas apropiado, dependiendo del uso de esta y de lo que queramos guardar adentro. Esto es llamado declaracion de una variable. Ahora, para guardar un numero dentro de esta variable hacemos lo siguiente: NombreVariable = 5 * El 5 es solo un ejemplo. * Le podemos asignar el numero a la variable apenas la creamos o luego de crearla, aca un ejemplo asignandole el numero en el momento que creamos la variable: PHP Code: new NombreVariable = 5 Ahora, para tener un grupo de numeros, necesitamos hacer uso de los arrays... de la siguiente forma: new GrupoVariable[x] * En x iria el numero que quieran, o que necesiten usar. Obviamente x no va, es solo un ejemplo. * Ese numero representa el numero de grupos que va a contener esa variable. * Y cada grupo puede contener un numero... Para acceder a cada grupo debemos hacer lo siguiente: new Color[3] // creamos una variable con un array de 3 grupos // Ahora para asignarle un numero a cada grupo: Color[0] = 255 Color[1] = 0 Color[2] = 0 // Como se habran dado cuenta, se empieza desde 0... por lo que el ultimo numero desaparece. // O sino tambien podriamos hacer asi: new Color[3] Color = { 255, 0, 0 } // Y por ultimo tambien asi: new Color[3] = { 255, 0, 0 } Pawn nos provee de operadores aritmeticos, entonces podemos hacer algo asi: new Color[3] Color[0] = Color[0] - 10 Color[1] = Color[1] - 10 Color[2] = Color[2] - 10 // Entonces antes de crear nuestro color podemos hacerlo mas oscuro, restandole una cantidad de 10 en cada monto de color // Ahora si queremos hacer lo mismo con varios colores, terminaria siendo re largo... por eso podemos crear algo llamado "funcion" de esta forma: OscurecerColores(Color[3]) { Color[0] = Color[0] - 10 Color[1] = Color[1] - 10 Color[2] = Color[2] - 10 } // Color[3] es solo un nombre que no necesariamente se tiene que usar, ahi van a ir los distintos colores que uno va a usar. // Entonces al crear esa funcion, despues la podemos a usar de forma simple para oscurecer distintos colores, de la siguiente forma: // Primero creamos las variables de los colores con sus arrays y sus valores de color. new UnColor[3] = { 100, 100, 100} new OtroColor[3] = { 50, 100, 150} new OtroColorMas[3] = { 255, 30, 233} // Y despues para oscurecerlos con la funcion que habiamos creado es simplemente asi: OscurecerColores(UnColor) OscurecerColores(OtroColor) OscurecerColores(OtroColorMas) // Esto automaticamente le resta 10 a cada valor de color. // Entonces los colores quedarian asi: /* UnColor = 90 90 90 OtroColor = 40 90 140 OtroColorMas = 245 20 223 */ Con este code anteriormente mostrado, tenemos un problema con la funcion creada. El problema es que si uno de nuestros colores tenie un numero como por ejemplo 0, al usar la funcion OscurecerColor, el color valor de tal color va a quedar en negativo (-10) y los valores de color deben ir entre 0 y 255. Asi que para eso debemos ponerle determinadas condiciones dentro de la funcion para que no suceda esto... y se hace de la siguiente forma: OscurecerColores(Color[3]) { Color[0] = Color[0] - 10 Color[1] = Color[1] - 10 Color[2] = Color[2] - 10 if(Color[0] < 0) { Color[0] = 0 } if(Color[1] < 0) { Color[1] = 0 } if(Color[2] < 0) { Color[2] = 0 } // Agarremos una condicion de ejemplo: /* if(Color[0] < 0) { Color[0] = 0 } */ // Lo primero es la condicion, quiere decir que si el primer valor es menor de 0 se cumple lo de abajo. // Y lo de abajo setea ese valor a 0. Entonces si el valor es menor a 0 (negativo) esta condicion hace que se quede en 0 y no se reste mas. } Ahora, para hacer que la funcion sea mas practica, les voy a dar el siguiente ejemplo: OscurecerColores(Color[3], parametro) { Color[0] = Color[0] - parametro Color[1] = Color[1] - parametro Color[2] = Color[2] - parametro } // Con esto hacemos que sea mas dinamico y que no necesariamente le reste 10, sino que le reste lo que queramos cuando usemos la funcion para oscurecer tal color... // Un ejemplo claro seria: new UnColor[3] = { 100, 100, 100} OscurecerColores(UnColor, 30) // Entonces el color nos quedaria: 70 70 70 // Tambien podriamos hacer algo asi: OscurecerColores(Color[3], parametro1, parametro2, parametro3) { Color[0] = Color[0] - parametro1 Color[1] = Color[1] - parametro2 Color[2] = Color[2] - parametro3 } new UnColor[3] = { 100, 100, 100} OscurecerColores(UnColor, 30, 50, 10) // Y nos quedaria asi: 70 50 90 // Esto es para que entiendan la forma en la que se puede agregar los distintos parametros en una funcion que creemos... Ah todo esto, obviamente podemos crear la misma funcion pero en vez de que sea para oscurecer, podemos hacer que "ilumine" o sea, que el color sea mas clarito. Y simplemente tenemos que cambiar el signo menos por el mas, de la siguiente forma: OscurecerColores(Color[3], parametro1, parametro2, parametro3) { Color[0] = Color[0] + parametro1 Color[1] = Color[1] + parametro2 Color[2] = Color[2] + parametro3 } Obviamente al hacer esto tmb vamos a tener el problema de que no tiene que superar los 255 del valor de cada color... por lo que tenemos que aplicar las mismas condiciones que hicimos antes pero en vez de usar el signo < debemos usar el > y para dar un pequeño ejemplo: if(Color[0] > 255) // Si el valor del color supera los 255 { Color[0] = 255 // Se setea lo maximo (255) }