Skip to content

kfischer-okarin/dragonruby-toolbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DragonRuby Toolbox

Github License

Useful classes & code snippets for DragonRuby GameToolkit

Table of content

Getting Started

Checkout the repository into your dragonruby folder and just start the demo with:

./dragonruby dragonruby-toolbox

All of the shared tools consist of one ruby file which you can copy in your game and require.

Contents

Autotiles

Autotiles

File to include: lib/autotile.rb

  1. Generate an autotile tileset from a source file like this:

    Autotile Source

    tileset_target = args.render_target(:grass_tileset)
    tileset_target.primitives << DRT::Autotile.generate_tileset_primitives('sprites/grass-autotile.png', 32)

    Above file will create a tileset like this

    Autotile Tileset

    You can skip this step and handcraft a tileset with above layout yourself.

  2. Create a tile object using the tileset

    grass_tile = DRT::Autotile.new(:grass_tileset, 32)
  3. Draw the correct tile by specifying which neighbor cells contain the same tile

    Method 1 (recommended): Create Autotile instances

    tile_instance = grass_tile.create_instance(x: 200, y: 200, neighbors: DRT::Autotile::Neighbors.new(:up, :right, :up_right))
    args.outputs.primitives << tile_instance

    Method 2: Render hash primitives

    rendered_tile = grass_tile.render DRT::Autotile::Neighbors.new(:up, :right, :up_right)
    rendered_tile[:x] = 200
    rendered_tile[:y] = 200
    
    args.outputs.primitives << rendered_tile

See the example source code and library code comments for more details.

Low Resolution

File to include: lib/low_resolution_canvas.rb

def tick(args)
  # Specify your canvas resolution as the first constructor argument
  args.state.canvas ||= LowResolutionCanvas.new([64, 64])

  args.state.canvas.background_color = [255, 255, 255]
  args.state.canvas.labels << [20, 60, 'test']
  args.state.canvas.primitives << [2, 2, 4, 4, 255, 0, 0].solid
  # Render your game content to your LowResolutionCanvas like you would to args.outputs

  args.outputs.background_color = [0, 0, 0]
  # Be sure to add your LowResolutionCanvas to args.outputs.primitives or args.outputs.sprites to render it to the screen
  args.outputs.primitives << args.state.canvas
end

[Quaternions]

File to include: lib/quaternion.rb

(Example coming soon)

Transformations

HSV and HSL

Color accessor

Damage Numbers

Get Help

I'm usually online in the DragonRuby Discord server as user kfischer_okarin. If you have any questions or suggestions join the server and ping me. :)

Contributing

This repository is not intended to be a comprehensive framework of any kind, but is rather a collection of tools I made I thought might be useful to share with whoever might find them useful.

If you find any bug or have an idea how to improve the usability of the tools, feel free to open an issue. Even better, just join the DragonRuby Discord channel (see Get Help) and discuss with me directly.

License

This project is licensed under the MIT License

About

Useful classes & code snippets for DragonRuby GameToolkit

Topics

Resources

License

Stars

Watchers

Forks

Languages