CRIANDO AUTO PATCHER!

As ferramentas para criação de GRF são:

- Gayconv - Converte os arquivos da pasta data.
- Unbollox - Mesma função do Gayconv mais funciona melhor (comigo xD)
- Grf Factory - Compacta os arquivos já convertidos e cria o grf/gpf

Todas essas ferramentas, podem ser encontradas neste site:

eAmirror

Lá você também encontra atualizações do SVN e diversos links para tutoriais importantes do eAthena!
(Lembrando que no eAmirror links diretos não são permitidos, você precisa ir no site oficial e baixar de lá.)

-=-=-=-=-=-
Download:
NeonCube 1.1 Beta

Mirror:
http://rapidshare.de/files/6141535/neoncub...5-1011.rar.html
-=-=-=-=-=-

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Indice:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

1- O que é um Auto-Patcher?
2- O que é o NeonCube?
3- Onde baixar o Programa?
4- Configurando o NeonCube
5- Compactando Gpf`s/Grf`s
6- Skins
7- Consideracoes Finais

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
1- O que é um Auto-Patcher?
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Bom, vamos ao conceito mais basico para entender conceitos mais complicados. O que é um autopatcher? Um autopatcher é um programa que faz o download das atualizações mais recentes do seu server. Assim, você não é obrigado a lançar o patch inteiro sempre que você adicionar alguma novidade no server, seja ela um custom item, um custom mob, ou qualquer outra coisa.

O Autopatch se baseia em um endereço Web e a partir dele faz o download de todas as atualizações existentes (que são passadas a ele atravéz de uma lista que deve ter o nome de patch2.txt).
O Autopatch acaba facilitando a vida de qualquer admin ja que para lançar um release novo, tudo que ele precisa fazer é atualizar a lista de arquivos (patch2.txt) e colocar o arquivo no servidor Web.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
2- O que é o NeonCube?
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Bom, para aqueles que nao sabem, o NeonCube é um tipo de AutoPatcher como o Prana-Updater e o RoLoader, mais com algo incomum. O NeonCube utiliza as duas vantagens de cada um dos AutoPatchers e une em um programa só.

A Vantagem que o Prana tem sobre o RoLoader, é que ele é capaz de fazer downloads de arquivos zipados (.zip) ou ripados (.rar) e extrai-los na sua pasta do kRO SEM PRECISAR E UM SERVIÇO FTP.

A Vantagem que o RoLoader tem sobre o Prana, é que ele é capaz de fazer downloads de arquivos com extensão '.gpf' e extrai-los no seu arquivo '.grf'. Assim, voce nao precisa ter uma pasta data. Desse modo, qualquer um que tenha o seu arquivo .grf já poderá jogar no server sem precisar ter que mover aquele montao de arquivos da pasta data. Mais tem um porem...o RoLoader precisa de FTP para poder funcionar.

Agora vem o NeonCube. O NeonCube consegue extrair os arquivos .gpf no seu .grf sem precisar de um ftp. (claro que o RoLoader tambem consegue fazer isso). O NeonCube agora vem com uma interface muito mais moderna e muito mais chamativa! E também disponibiliza o source do programa para que qualquer um possa entrar e configurar sua própria Skin. O NeonCube pode extrair seus arquivos tanto em formato .rar, tanto em formato .zip e tanto em formato .gpf.
O NeonCube possui um estilo de configuração parecido com o RoLoader, mais quando eu configurei, logo vi que tinha uma estrutura/interface bem mais simples que o RoLoader.

Apesar de tudo, o NeonCube ainda se encontra em fase Beta e qualquer problema, qualquer bug, ou falha GRAVE deve ser reportada neste link -> http://hatsukoi.ff.st/grfworks/forum/ .
Mais lembre-se, reporte se voce encontrar algo que NINGUEM conseguiu resolver.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
3- Onde baixar o Programa?
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Bom, quando este tutorial foi montado, o programa estava na sua versao BETA 1.1. E essa versao pode ser conseguida no site oficial ou atravéz do link abaixo:

Download do NeonCube 1.1 (BETA)

Agora se voce quiser checar por alguma atualizacao nova voce pode visitar o site oficial:

http://openkore.sourceforge.net/neoncube/

Se algum link estiver quebrado é só me avisar. E outra coisa..se alguém arranjar um mirror eu vou agradeçer xD (só por segurança neh =P)

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
4- Configurando o NeonCube
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Bom, primeiro vou mostrar a voces a interface do programa:

Para a Skin Default:



Para a Skin Red: Clique aqui para ver
(imagens cedidas pelo topico do NeonCube no forum Client Support)

Certo, agora que voces ja viram a interface do programa, podemos começar a configura-lo. E em falar nisso..gostaram dele?

Bom, para configurar o NeonCube voce vai precisar de 3 coisas básicas:

1- O NeonCube (baixe no site)
2- Um Hexed Client no mesmo diretório que o NeonCube.exe (pode ser o que voce usa no seu server)
3- Um arquivo .grf que contenha OBRIGATORIAMENTE algum arquivo dentro! Ele precisa estar tambem no mesmo diretorio que o NeonCube.exe (eu vou explicar como fazer isso mais pra frente...)

Então, logo que você baixar o NeonCube, coloque ele em alguma pasta, aqui vamos supor que voce colocou na Pasta AutoPatcher.

Agora, dentro da pasta 'neoncube', existe um arquivo chamado 'neoncube.ini'. Agora acompanhe o quadro abaixo para configurar ele:

neoncube.ini:


QUOTE
;##############################################################################
;## NEONCUBE - RAGNAROK ONLINE PATCH CLIENT
;##
;## http://openkore.sourceforge.net/neoncube
;## © 2005 Ansell "Cliffe" Cruz (Cliffe@xeronhosting.com)
;##
;## This program is free software; you can redistribute it and/or modify
;## it under the terms of the GNU General Public License as published by
;## the Free Software Foundation; either version 2 of the License, or
;## (at your option) any later version.
;##
;## This program is distributed in the hope that it will be useful,
;## but WITHOUT ANY WARRANTY; without even the implied warranty of
;## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;## GNU General Public License for more details.
;##
;## You should have received a copy of the GNU General Public License
;## along with this program; if not, write to the Free Software
;## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
;##
;###############################################################################

; neoncube.ini
;
; server_name = Server's name (EG: Korean Ragnarok Online, International Ragnarok Online, mRO, aeRO, etc)
; notice_url = address of the notice (without the http://) (EG: www.domain.com/notice.php)
; patch_url = domain name of the patch server (where the files will be downloaded) (EG: www.patchserver.domain.com)
; patch_list = path to the patchlist text document (EG: /path/to/patchlist.txt)
; executable = the file to be opened when the start game button has been pressed (EG: ragnarok.exe)
; patch_folder = path to the folder which contains the patch files (EG: /path/to/folder/which/contain/patches/)
; registration_link = URL of the registration page (EG: http://www.domain.com/register.php)
; grf = grf file (EG: adata.grf)
; skin = skin to use (EG: default_skin)
; Backup_GRF = set to 1 if you want to backup the GRF file before applying the patch. 0 to disable.
; startup_option = Set to 1 if you want to be able to start the ragnarok client anytime. (patcher is still
; downloading files, patcher failed to connect, patcher failed to extract, etc).
; Set to 2 if you want to be able to start the ragnarok client only AFTER the patch process has completed (if it ; ; fails to connect/download a patch, it won't start) .
; set to 3 if you want to be able to start the ragnarok client only AFTER the patch process has completed (if it
; fails to connect/download a patch. it WILL start) . recommended.
; ragexe_call = ragexe call. You may leave it blank.

[server]
server_name = Nome do seu Server //coloque o nome do seu server aqui.

notice_url = www.renatoweb.com/patch/page/news.php //endereço da página que vai conter a página que é exibida logo quando você abre o neoncube.exe (sem o 'http://')

patch_site = www.renatoweb.com // Site que vai contem os patchs (novamente sem o 'http://')

patch_list = /patch/patch2.txt // Pasta que vai conter o arquivo patch2.txt (o patch2.txt contém a lista dos arquivos a serem baixados)
executable = client.exe // Nome do executavel a ser chamado ao se clicar no botao 'Start Game' do NeonCube

patch_folder = /patch/files/ // Pasta onde vão estar os arquivos que o NeonCube vai baixar.

registration_link = http://ragnarok.co.kr // Mude aqui para o endereço do seu site.

skin = skin_red // Aqui voce pode usar ou skin_red ou skin_default. Dependendo do que voce escolher o desenho do AutoPatcher vai mudar pra uma das imagens que eu postei lá no inicio do tutorial.)

grf_file = adata.grf // Nome do seu arquivo .grf

Backup_GRF= 1 // Deixe assim por enquanto

startup_option = 3 // Deixe assim por enquanto

ragexe_call = 1rag1 // Deixe assim...



É lógico que para poder colocar seus arquivos você precisa ter um hoster, ou seja, alguém pra você mandar os seus patchs...eu aconselho:

http://www.xoopiter.com

Ou voces podem usar um outro site que eu achei ( alias, que o Snails achou! ) de Free hosting....e sinceramente gente, eu do fundo do meu coraçao tenho uma dó imensa de estar passando esse site pra voces porque ele é melhor que o xoopiter...aguenta 500mb, tem bandwidth quase ilimitada e os uploads não tem limite de envio........ou seja...eu tenho mta dó de passar esse link pra vocês mais já que eu não sou uma pessoa egoista..eu vou passar:

http://www.free-hoster.cc

xDDDDDDDD Façam bom uso e aproveitem!!!!!! (enquanto é free )

Mais para pode fazer esses uploads você primeiro precisa ter os gpfs!! Senão do que adianta ter um autopatcher bom desse!?

Se voce configurou tudo direitinho você não vai ter problemas...vamos para....

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
5- Compactando Gpf`s/Grf`s
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Primeiro. Para que o seu patch funcione, você precisa de um arquivo .grf nomeado com o nome que você escolheu na configuração do NeonCube.ini. (geralmente usam o nome adata.grf). Só que ai é que está a questão. Onde criar esse arquivo .grf? Voce precisará ter um programa chamado Gf Tool e precisará do Gayconv pra criar seus patchs em extenção .gpf.

Essas duas ferramentas podem ser conseguidas atravéz do link que segue abaixou ou no inicio do tutorial:

GRF Tool e GayConv

Agora que você possui essas ferramentas poderemos falar em outra lingua .

Se você quer criar seu arquivo .gpf lembre-se que você precisa passar ele no GayConv, para criar esses arquivos, de uma passada no tutorial da Vampi sobre como criar arquivos .grfs (também serve para .gpf's):

http://www.eathena.ws/board/index.php?showtopic=22748

(Lembrando que eu estou fazendo essa 'linkagem' no tutorial porque senao ele acaba ficando muito extenso, agora se vocês acharem necessário montar um tutorial de como fazer .gpfs aqui eu monto sem problemas, mais o objetivo inicial do tutorial é ensinar como se usa o NeonCube.)

Então supondo que você já tem a posse dos seus arquivos '.gpf'. Você precisa enviar eles para o seu site na web. (sempre que for criar seu .gpf no GF Tool compacte ele em 0x103 para que funcione bem). Faça o upload dos arquivos e mande-os então para o site da WEB.

Agora supondo que os seus arquivos de patch se chamam 'patch1.gpf' e 'patch2.gpf' voce precisa agora criar a lista de arquivos, que é o arquivo patch2.txt.

O patch2.txt também precisa estar na web e deve conter a lista de arquivos que o NeonCube vai baixar. Veja um exemplo:


QUOTE
1 GRF patch1.gpf
2 GRF patch2.gpf



É desse modo que você deverá escrever no seu arquivo patch2.txt e mandar para a web.

Agora vem uma convenção. Prestem atenção que depois do numero 1 exite o termo 'GRF'. Isso significa que quando o NeonCube baixar o arquivo patch1.gpf ele vai extrair esse arquivo no seu '.grf'. Agora se você colocar o termo 'FLD' ao invez de GRF:


QUOTE
1 FLD patch1.gpf
2 GRF patch2.gpf



Perceba que o arquivo patch1 está como FLD e o arquivo patch2 está como GRF. Então quando você abrir o prana, ele vai pegar o patch1 e extrair NA PASTA DATA, e depois vai pegar o patch2 e extrair DENTRO DO SEU GRF.

Pronto, basta montar a lista de seus patchs e mandar para a Web no endereço que voce especificou na configuração do NeonCube:


CODE
patch_list = /patch/patch2.txt



Agora para que o NeonCube extraia por exemplo,o patch2 dentro do seu GRF você precisa ter um arquivo grf. E esse arquivo GRF OBRIGATORIAMENTE precisa ter PELO MENOS 1 (UM) arquivo dentro.

Eu coloquei isso porque se voce colocar no seu autopatch um .grf que esteja vazio, quando o download do seu patch terminar, vai aparecer escrito:

"Failed to extract do xdata.grf"

Tomando xdata.grf como o nome do .grf que você escolheu na configuração do neoncube.ini.

Se vocês não conseguiram entender vou postar o quote de um usuario que postou no tópico pinado do NeonCube na sessão de Client Suport: (o nome dele é halph)


QUOTE
ENGLISH
====================================>

Wow, mt first post in this forum...
About the "can't extract file.grf" or "can't write file.grf.txt" problems, i know what u have to do.
After many tryes to stop this error i discovered that your .grf file (that witch neoncube will extract your GPFs) can't be blank, cos if it's blank, neoncube won't be able to extract the files from your grf (because ther is no file), so it will give you an "can't extract file.gpf" message.Also, you must delete any grf file that is inside neoncube folder (the same folder as neoncube.ini).

Well, that's all.It worked for me.
(Sorry about gramatical errors, my english is no good...)

PORTUGUS
====================================>

Meu primeiro post nesse fórum

Bom, pra quem tem o problema do "can't extract file.gpf" ou "can't write data.gpf.txt", eu encontrei a solução...e ela é muito simples.
O seu arquivo .grf, o q o neoncube vai adicionar seus arquivos gpf, n pode esta em branco, ele tem q ter algum arquivo dentro, nem q seja um arquivo q o RO n usa.
Outra coisa...c vc tiver dentro da pasta do neoncube (a em que fica o neoncube.ini) algum arquivo .grf, deleta ele ou ele vai da o problema "can't move file.grf to original patch.".

Bom, espero ter ajudado.



Não sei se eu consegui explicar direito mais qualquer dúvida é só postar aqui. xD