Kuby
Crash your Kerbals using Ruby!
Kuby is a Ruby wrapper for the game Kerbal Space Program. This gem exposes a simple DSL with which you can control your rockets.
Installation
Install the gem:
$ gem install kuby
Make sure you have a recent version of KSP and also install the Telemachus plugin.
Usage
Basic example
Create a ruby file with the following contents (simple_launch.rb for example):
require 'rubygems'
require 'kuby'
# Optional parameters :host, :port, otherwise defaults will be used (127.0.0.1:8085)
link = Kuby::Link.new
# Connect to KSP
link.connect!
# Initiate first stage
link.stage!
# Set to full throttle
link.throttle_full
# Activate SAS
link.toggle_sas
Now create a new rocket in KSP or load an existing one. Be sure to add one of the Telemachus antennas to it, otherwise your rocket won't be able to communicate. Now go to the launchpad and when the ship is loaded and you are ready for launch, execute the following command in a terminal:
$ ruby simple_launch.rb
Kuby will connect to your rocket and issue the commands in the order you specified in the file, your rocket will activate the first stage, go to full throttle and enable SAS. After that, the script ends but your rocket will keep flying.
Advanced example
This example will fly your rocket to ± 150 meters and then keeps it floating there by changing the throttle using an implementation of a PID controller
require 'rubygems'
require 'kuby'
# Optional parameters :host, :port, otherwise defaults will be used (127.0.0.1:8085)
link = Kuby::Link.new
# Connect to KSP
link.connect!
# Initiate first stage
link.stage!
# Set to full throttle
link.throttle_full
# Activate SAS
link.toggle_sas
# Wait untill we're at 150 meters
while link.altitude < 150 do
sleep 0.2
end
target = 0.0
previous = 0.0
error = 0.0
integral = 0.0
derivative = 0.0
time = link.mission_time
loop do
dt = link.mission_time - time
time = link.mission_time
error = target - link.vertical_speed
integral = integral + error * dt
derivative = (error - previous)/dt
new_throttle = (error/10 + integral/15 + derivative/30)
if new_throttle > 1.0
new_throttle = 1.0
elsif new_throttle < 0.0
new_throttle = 0.0
end
link.set_throttle new_throttle
previous = error
sleep 0.2
end
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request