Replies: 3 comments 25 replies
-
|
@SirStone A bot API might be as simple as the BaseBot from the JVM and .Net APIs. That is a thin layer on top of a web socket. In order to make a Bot API, all aspects involving a "bot" with the schemas must be implemented, which is not very complicated. Basically, a bot must:
You can decide how the API must be, but the ones provided for JVM (Java) and .Net should serve as good sources of inspiration. Btw. there is no need for reverse engineering in the current Bot APIs, as the sources are provided as Open Source, and they have been kept as simple and straightforward as possible. At least that has been the intention. If you think I should write an article about it, then I should like to know where I should put my focus. E.g. the bits that are unclear to you. And I should like you to review it, and perhaps use it for writing a bot API for the language of your interest. That would serve as a good use-case. 🙂 |
Beta Was this translation helpful? Give feedback.
-
|
Thanks for the fix, I'm going to provide you with moree bugs and feedback in the future more I lean to the completition of the bot library in NIM. NIM is very powerfull, still in early stage and under fast development. In short, has the style and readability of programming of pyhton but is compiled to an optimized C code or other languages, from the documentation I've read that even compilation to Javascript is possible. I didn't explored all the capabilities of this language. Stop to the chitchat, here I am to ask you again something about the implaementation.
is this one launched before the run()? Meaning that I could use this function to do somethign before the actual run() method is called?
Thanks in advance and Happy Christmas! |
Beta Was this translation helpful? Give feedback.
-
|
@SirStone Regarding your questions:
@Override
public void onHitByBullet(HitByBulletEvent e) {
System.out.println("onHitByBullet");
}This works fine with the Java version of the Bot API, and I expect it to work in the .Net version as well. |
Beta Was this translation helpful? Give feedback.
-
|
I fixed this weeks ago but I want write here for others why I could not see the "hit by bullet events": About the run() method, do you think is fundamentally required? I still need to dip into NIM threads and I was thinking to delay this at the end, but I thnik I reached the moment where I need it if i want to make this API with the same capabilities as yours. |
Beta Was this translation helpful? Give feedback.
-
|
Regarding the run() method, that has been taken from the original Robocode. It is present for the IBot/Bot, but it is not used for IBaseBot/BaseBot. |
Beta Was this translation helpful? Give feedback.
-
|
I'm very happy to say that with version 0.17.0 of my Bot API in Nim I think I've implemented all the most difficult parts: run(), turning left/right, radar left/right, gun left/right and forward/back. I feel the rest of what is left to implement will be easy or at least easier and I see the light at the end of the tunnel I have a big doubt about my impementation of forward() and back(), from my tests it works well but looking at my code and yours my code looks much much simpler, I knwo that I miss some control flows fo special cases but the core of the calculation looks quite different to me and reading the blogs that opens following the links in your comments make me feel I'm missing something big. Probably time will solve my riddle. I've crated a testing tool that creates a list of test with random values an random actions and the bot will execute all tests, in sequence using the blocking calls (ex. forward() instead of setForward()) so I can keep track of each action and check at the end of it if the action have been completeted correctly and write results in CSV file, this is an example of 30 random acitons repeted for 3 rounds: I'll keep this thread for ongoing updates and questions, as soon as I release the version 1.0.0 I will create a new thread in "show and tell" explaining how to use it and what are the differences with the Java based bot-api (I never used the C# ones) |
Beta Was this translation helpful? Give feedback.
-
|
@SirStone The Bot API comes in two levels:
The Bot is harder to do, as it needs to keep track of exactly how much it has already been moving, with e.g. forward() from turn to turn. And it needs to take acceleration and deceleration into account using formulas from physics. This was (eventually) done for the original Robocode (from the RoboWiki blog), and I reused this code for Tank Royale. |
Beta Was this translation helpful? Give feedback.
-
|
@SirStone I have sent you an invition (today) as a Collaborator. 😊 It would be really nice to include the diagram to your guide on the Wiki page. |
Beta Was this translation helpful? Give feedback.
-
|
hello Now I have, what I believe , a better version of it, and should be fully supported by github so I plan to update the wiki with the mermaid code in it. I've made a try to push from local to remote to this url git@github.com:robocode-dev/tank-royale.wiki.git but I've received this message: ERROR: Permission to robocode-dev/tank-royale.wiki.git denied to SirStone. I think that this is correct, because I should be able to create a pull request and not push directly to the repo but I don't know how to do that with the wiki repo. I can confirm that I list as collaborator for the main repo, but the wiki is a different repo and probably with different permissions to handle. I don't see any help from the Web interface either: For the moment I want to paste the diagram here, I want to test that the syntax is working, I've tested only on my Gitea private server. This should describe what I think should be (or help me find out) the best way to implement the Bot Library interaction with the user code, the library and the game server process.Actors
sequenceDiagram
participant SERVER
participant LIB
actor BOT
participant IntentSender
participant BotRunner
activate SERVER
Note over BOT: the user starts the bot <br> by activating the library
activate BOT
BOT->>LIB: start(json)
deactivate BOT
activate LIB
Note over LIB: connection with the server
Note over LIB: listening for events <br> from the server
SERVER--)LIB: roundStarted-event
Note over LIB: set RUNNING to true
activate LIB
LIB--)BOT: onRoundStarted(event)
activate BOT
deactivate BOT
LIB--)BotRunner: create a new BotRunner
activate BotRunner
LIB--)IntentSender: create a new IntentSender
deactivate LIB
activate IntentSender
Note over BotRunner: START
Note over IntentSender: START
IntentSender->>IntentSender: while is RUNNING <br> wait GO
deactivate IntentSender
BotRunner->>BOT: BOT custom run()
deactivate BotRunner
activate BOT
loop usually doesn't return until RUNNING is true
opt BOT can call for a go() at any time
BOT->>IntentSender: go()
deactivate BOT
activate IntentSender
IntentSender--)LIB: sendIntent()
activate LIB
LIB--)SERVER: Intent
deactivate LIB
IntentSender->>IntentSender: wait NEXT_TURN
IntentSender->>BOT: return go()
activate BOT
IntentSender->>IntentSender: while is RUNNING <br> wait GO
deactivate IntentSender
end
end
BOT->>BotRunner: return BOT custom run()
deactivate BOT
activate BotRunner
loop while bot is RUNNING
BotRunner->>IntentSender: go()
deactivate BotRunner
activate IntentSender
IntentSender--)LIB: sendIntent()
activate LIB
LIB--)SERVER: Intent
deactivate LIB
IntentSender->>IntentSender: wait NEXT_TURN
IntentSender->>BotRunner: return go()
IntentSender->>IntentSender: while is RUNNING <br> wait GO
deactivate IntentSender
end
Note over BotRunner: EXIT when RUNNING is false
SERVER--)LIB: tick-event
Note over LIB: notify NEXT_TURN
opt Events that can occur anytime
SERVER--)LIB: bot-death-event <br> won-round-event <br> game-aborted-event <br> game-ended-event <br> round-ended-event
activate LIB
Note over SERVER,LIB: all these <br> set RUNNING to false
LIB--)BOT: onDeath(event) <br> onRoundWon(event) <br> onGameAborted(event) <br> onGameEnded(event) <br> onRoundEnded(event)
deactivate LIB
activate BOT
deactivate BOT
SERVER--)LIB: generic-event
activate LIB
LIB--)BOT: onGenericMethod(generic-event)
deactivate LIB
activate BOT
deactivate BOT
end
opt BOT can call for a go() at any time
BOT->>IntentSender: go()
activate IntentSender
IntentSender--)LIB: sendIntent()
activate LIB
LIB--)SERVER: Intent
deactivate LIB
IntentSender->>IntentSender: wait NEXT_TURN
IntentSender->>BOT: return go()
IntentSender->>IntentSender: while is RUNNING <br> wait GO
deactivate IntentSender
end
Note over LIB: @any moment<br>as the CONNECTION is false <br> set RUNNING to false <br> and the bot will EXIT
LIB--)BOT: onDisconnectMethod(disconnect-event)
activate BOT
deactivate BOT
deactivate LIB
Note over LIB: EXIT
Note over IntentSender: EXIT when RUNNING is false
Note over SERVER: unknown status
deactivate SERVER
|
Beta Was this translation helpful? Give feedback.
-
|
@SirStone This look really good to me, and I see that GitHub seems to show your sequence diagram just fine. 😊👍 I have provided your user with |
Beta Was this translation helpful? Give feedback.
-
|
Thanks! Now the push worked fine. Now I hope to slowly improve the all-around information I can provide on the matter of developing the bot API. |
Beta Was this translation helpful? Give feedback.
-
|
@SirStone Nice. I am happy to hear that you are finally able to update the Wiki. 😊👌 |
Beta Was this translation helpful? Give feedback.
-
|
@flemming-n-larsen I have some questions now, about how some details work in your original bot API and today I would like to focus on... blocking callsMore I think about these more I'm confused. The basic should be "while a blocking call is not completed not other calls are allowed, forcing the bot to take one action at time" example 1Walls uses on blocking calls, so it starts walking the wall and, using blocking calls like forward(moveAmount) should not be able to do nothing until the command is completed, instead onScannedBot the bot is able to call fire(2), another blocking call, and fire to the enemy and without interrupting or be blocked by the previous forward(moveAmount) command example 2I've made a simple Java bot with this behavior: starts spinning right forever using a blocking call, as a bullet hits the bot, it uses another blocking call to start spinning on the other direction. From my tests I see the bot start spinning right, at first hit the bot prints the message and changes the spinning direction, but only once, and is not responding to the bullet hits anymore until death. This is the code import dev.robocode.tankroyale.botapi.*;
import dev.robocode.tankroyale.botapi.events.*;
public class JavaTester extends Bot {
int direction = 1; // Clockwise or counterclockwise
public static void main(String[] args) {
new JavaTester().start();
}
JavaTester() {
super(BotInfo.fromFile("JavaTester.json"));
}
@Override
public void run() {
while (isRunning()) {
turnRight(Double.MAX_VALUE * direction);
}
}
@Override
public void onHitByBullet(HitByBulletEvent event) {
System.out.println("Ouch, I got hit by a bullet!");
direction = -direction;
turnRight(Double.MAX_VALUE * direction);
}
}PS: Happy Holiday to all readers! |
Beta Was this translation helpful? Give feedback.
-
|
Beta Was this translation helpful? Give feedback.
-
|
Wow, I've never found about this limitation, this shine some light on the matter but I have still some dark zones, sorry So let's pretend this:
|
Beta Was this translation helpful? Give feedback.
-
|
@SirStone Regarding 3) When new events occur, the event will be queued in the event queue. Howver, the event dispather do clean up old events. So event older then 2 turns are discarded: The removeOldEvents is doing this: Notice that some event are marked as critical. Such event will not be removed. |
Beta Was this translation helpful? Give feedback.
-
Hi
I'm finding some interest in using a different programming language for the bots, is there any document that would explain better this piece of software than reverse engineering the java/c# code?
Beta Was this translation helpful? Give feedback.
All reactions