[Plugin] [ALPHA] Project Shoebill - Java for SA:MP Development Kit - Milestone 1 (20110701)

[mk124]

Project Shoebill - SA:MP Gamemode Development Kit for Java (Windows Only)
Milestone 1 (20110703) - Release


<- Shoebill



This is an Object-Oriented Java library for developing SA-MP gamemode,
consist of two parts, plugin and java library.

Features:
Java development
Object-Oriented
Event handling
Codepage/Unicode support

System requirements:
Must be Windows
JRE/JDK 6
Environment variable "PATH" must include (java dir)\bin\client or (java dir)\bin\server

What this can do?
With this, you can develop new gamemode with object-oriented programming, in java.
By borrowing Java's develop capability, you can program a very powerful gamemode.

Why no Linux?
The main reason is, libiconv doesn't support transformation between simplified chinese and traditional chinese.
and I dont know how to cross platform!

Project:
Hosted at GitHub:
https://github.com/mk124/Shoebill

Contributors:
MK124 <mk124a@gmail.com>
JoJLlmAn <jojllman@gmail.com>

License:
Apache License, Version 2.0

Javadoc:
http://gtaun.net/shoebill/doc
We dont have any comment on javadoc yet, sorry for that.

Update:
Milestone 1 (20110703): enabled JIT, improved the performance.

Downloads:
AMX&DLL&JAR: Shoebill.zip
Source: Shoebill_SRC.zip

Performance:
Shoebill Milestone1 (20110703) Simple performance test


Appreciation to all the support, especially to June, 258921, and Shindo.
English translation by JoJLlmAn and he says: Sorry for my poor english. =)

Other Language: [中文/Chinese]

[mk124]

Preparation for Shoebill development (ex. Eclipse)

1. Eclipse -> File -> New -> Java Project -> Enter your project name -> Finish.
2. Right click at the new project -> new -> Choose "Folder" -> enter "lib" -> Finish.
3. Copy the Shoebill.JAR into the new "lib" folder in your project.
4. Right click at the project -> Properties -> Java Build Path -> Libraries -> Add JARS -> find lib/Shoebill.JAR
5. Create your own GameMode class, and extend net.gtaun.samp.GameModeBase.
6. Finished! Now you can program your own code.

*How To export your gamemode to JAR?
Just right click at your project -> export -> JAR File -> assign where to save your .jar


Preparation for Shoebill execution

1. Prepare samp_server folder, include samp_server.exe
2. Copy Shoebill.AMX & Shoebill.JAR into "gamemodes". Copy Shoebill.DLL into "plugins"
3. Copy your own gamemode.jar(ex. LVDM.JAR) into "gamemodes"
4. Prepare server.CFG. Modify gamemode0 to "gamemode0 Shoebill 1", and plugins to "plugins Shoebill", and delete the filterscripts line.
5. Add a new line into server.CFG, that would be "modeclass [your GameMode class name]" (ex. "modeclass com.samp.lvdm.GameMode")
6. Prepare your scriptfiles for GameMode
7. Now you can try to execute the samp-server.exe


Example GameMode: LVDM

Download: LVDM(Java).zip
(Updated in 02/07/2011)

*Convertd by JoJLlmAn, all copyright belongs to Jax and SA-MP TEAM.


That's it!, enjoy using it.
Greetings to all Java lovers.

[Mauzen]

One of the best ideas I have seen so far.
Have you tested the speed yet? I guess java will be slightly slower, but OO is a great feature that could compensate it, nice to see it already works.

[JernejL]

A suggestion on optimization, initialize all amx_FindFunction(***) pointers in initialization and CACHE them so they aren't always looked up on each native calls, but are known in advance.

[langricr]

Awesome work, I was initially developing a Java-based gamemode that would communicate with the native server using my plugin. This cuts out the middle man, good luck!

[Toni]

This is very nice! Still kinda bummed about the Linux thing though ;-;.

[Gomma]

This sounds pretty epic. But it kinda sucks that it won't be compatible with Linux.

[Steven82]

Originally Posted by Mauzen

One of the best ideas I have seen so far.
Have you tested the speed yet? I guess java will be slightly slower, but OO is a great feature that could compensate it, nice to see it already works.

I second that, nice work.

[Y_Less]

This is a very impressive piece of work, though some things do seem like a lot of work - is that really the only way to set a vehicles numberplate on spawn!?

Now a Haskell GM system would be awesome!

[Rock_Ro]

Hard...i will try but i am 100% sure that i can't use it.