Squib: A Ruby DSL for prototyping card and board games

http://andymeneely.github.io/squib/

by selvan • 11 years ago

215 44 11 years ago

andymeneely.github.io

benlaud• 11 years ago

You force me to learn Ruby...

cosarara97• 11 years ago

Be happy you got an excuse to learn another programming language.

codinganarchy• 11 years ago

Wait, we're supposed to have excuses for that? I've just been doing it for fun.

GaiusCoffee• 11 years ago

Looks cool. I don't know ruby though.. :(

asQuirreL• 11 years ago

You don't know ruby yet.

egeozcan3• 11 years ago

I really like it. It's like re-inventing email templates for playing cards. OTOH, can't static site generators be a bit more flexible for such tasks? I guess I'll need to give it a try, but first I need to learn a bit ruby I suppose.

Marazan2• 11 years ago

Everyone should write their own static site generator.

egeozcan3• 11 years ago

I wasn't talking about a new one, but using an existing one to generate card-style pages. One could then run a script to render them to svg/png images by using something like Phantom.js. Just an idea.

calineczka• 11 years ago

It looks fantastic for rendering the cards :)

zyxley• 11 years ago

I wonder if it'd be possible to recreate Magic: the Gathering cards using this. It'd be nice to have an alternative to Magic Set Editor for high-quality cards.

eru2• 11 years ago

Oh, I was hoping for a DSL for prototyping the rules to play these kind of games on a computer (and perhaps train a neural network as an AI opponent). I've been working out how to do these things recently.

gedrap3• 11 years ago

Actually, sounds interesting. You could use it to discover flaws in the game play, given you can quantify 'bad / boring gameplay'.

comrh2• 11 years ago

It isn't a language but Tabletop Simulator [1] is basically the ultimate in simulating any board or card game.

1: http://store.steampowered.com/app/286160/

lfowles2• 11 years ago

Correct me if I'm wrong, but isn't Tabletop Simulator only about physical simulation? VASSAL seems much closer to what parent is looking for (but there's still very little on the rules verification front there).

mmanfrin• 11 years ago

Yonatan Bergman gave a talk last year at GoGaRuCo about building a really rudimentary AI to test a board game prototype in ruby:

https://www.youtube.com/watch?v=EcnvbsXdbtI

evolve2k• 11 years ago

Just watched his talk, def worth a watch (Thx for the link).

The repo is below, he added disclaimers that it's rough code and was enough to help him make some useful decisions mainly around game length and balance as he developed his game.

https://github.com/yonbergman/missiles_and_microchips

rndstr• 11 years ago

I once wrote a multiplayer cardgame server (with a friend) that provided a Game API[0] to Lua scripts to define state and behavior. We scripted multiple card games popular in my country. For example Ace's Up[1].

We also wrote a few clients (ncurses, android, flash), most of them remained unfinished/unreleased, including the server, unfortunately. I meant to put it on GitHub but still hesitating since it would only be for educational purpose and no real interest in pursuing the project much further.

[0] https://gist.github.com/rndstr/fd7c85d8ee7fad800000 [1]: https://gist.github.com/rndstr/fd7c85d8ee7fad800000#file-gam...

gedrap3• 11 years ago

I shared it with my colleague who's not into programming but loves board games, that got him quite excited.

So I thought that this project can be used as a motivator to teach kids programming :) because it's like look kids, with this simple code, you can generate these awesome cards, isn't it great?

kriro2• 11 years ago

This is a pretty excellent idea. It seems like a good idea in general to have code create something physical as a motivation. Another cool project would be a treasure map DSL or something similar...heh your comment got me thinking :)

Maybe a DSL for describing simple 3D printable stuff would be an option if a printer is available.

gedrap3• 11 years ago

3D printing is great because it's something physical and useful.

Other physical alternative is, quite obviously, Arduino. I have no experience teaching kids but I think that it would be a really solid option too given they implement something useful (to some extent), and that's a really important point.

I mean a blinking LED is cool for the first time but then you just forget about it. But for playing cards, or 3D printed stuff, it's something you can actually use it and you can keep improving it, driving more learning.

Given the adoption of Arduino, I'd be surprised if no one has developed a solid course for kids yet.

troels• 11 years ago

Very cool. I have a bunch of html templates and imagemagick scripts for this, but always thought I would turn it into a more coherent suite at some point. Glad someone did it for me!

milkworsethan• 11 years ago

I don't have any use for this but it looks really neat given how simple it is to create the set of rules to generate cards, nice work.

markmywords• 11 years ago

Thanks for sharing, this looks really nice. Does anyone know similar projects that help with developing card- and/or boardgames?

lorennorman2• 11 years ago

There's our project, Paperize: http://paperize.io (spoiler alert: we're still invite only/early access!)

It's a web app, not a code library, but we're solving similar problems. We love Squib though, keep up the good work!

andymeneely3• 11 years ago

I'm really excited about Paperize. I can't wait to see more of what you're up to.

kriro2• 11 years ago

Very interesting. I'm interested in the same space alas I focus on prototyping the physical game virtually not generating physical prototyping materials. My vision is building a GUI where you can define game objects which generates JSON (I had something like a game DOM in mind). However I've been pondering how to get the actual rules system done/integrate it. It would be a lot nicer if one could define the rules via a DSL and link game objects to rules graphically than to implement them ad hoc.

I'm mostly interested in rules based systems and AI and my research was leaning towards creating a DSL for describing players' strategy. I started out doing it in Prolog as an internal DSL but switched to ANTLR and changed it to an external DSL. Ruby is a pretty great choice which I considered before moving to ANTLR.

Edit: As this is geared more towards creating physical prototypes you should post this on boardgamegeek if you haven't already.

andymeneely3• 11 years ago

Ok, so this is something I also want to do someday. It's not what Squib is at all, but I feel like we need better tools board game simulation and machine learning. In particular, I'd like to simulate the game with very basic AI, then analyze the games to look for overpowered moves (e.g. if 75% of all winners used Black Lotus).

I'm trying to do this in an ad hoc way on my own games, but progress is slow :(

lfowles2• 11 years ago

I'd recommend talking with the VASSAL people if you haven't already. I was looking into something similar (defining pieces and rules in a DSL that would spit out an engine suitable for AI) a few months ago when I was all motivation and no outlet.

pepsin• 11 years ago

This is insanely awesome!

rodw• 11 years ago

I've never used it, and believe I'd prefer a text-based declarative framework like Squib for this task, but just an FYI for everyone, there is a GUI program called nanDeck [1] that is often used for this purpose.

For what it's worth, I've occasionally used a little LaTeX framework derived from [2] to create fairly high-quality prototype cards. Perhaps a LaTeX or PS output from Sqiub would be a useful extension.

From a quick skim though, I think I'll be giving Squib a try the next time I want to do something like this.

[1] http://www.nand.it/nandeck/

[2] http://tex.stackexchange.com/questions/47924/creating-playin...

PS: If you are looking to promote Squib, as might already be obvious to you, I'd recommend /r/boardgamedesign [3] and somewhere (I'm not sure where) on BoardGameGeek [4]. The latter might be especially interested as many people seem to create custom "fan decks" for existing board games. For example, the game Love Letter is frequently re-skinned or re-themed as seen at [5].

[3] http://www.reddit.com/r/boardgamedesign

[4] https://boardgamegeek.com/

[5] https://boardgamegeek.com/files/thing/129622

Schwolop• 11 years ago

I did the same thing as you with Python + LaTeX + Tikz. I think I used the same stackexchange question as a starting point too... Here's a view of my deck: http://1drv.ms/1LREWSM

There's also http://paperize.io/prototypes which has recently opened up for a beta testing phase.

crobi2• 11 years ago

What I like:

- Data driven

- High-quality output

- Raster and vector output

What I don't like:

- Complicated to set up (install Ruby, install multiple dependencies, compile code). This will scare away many potential users.

- Complicated to use (edit text files and run command line scripts). While I like this workflow personally, I feel this will again scare away some people.

- There's already many generic tools where you can write scripts to produce images from input data. Maybe you could explain why your tool is better suited for designing cards, given how complicated it is?

andymeneely3• 11 years ago

I simply made a thing that I wanted to use. And then made it open source in case anyone else wanted to contribute. I've used a ton of tools for this task for nearly 10 years now - most notably nanDeck, but trying out just about everything else. I kept saying, "this is cool, but I want to do it in Ruby".

I also wanted an open source alternative to nanDeck. I love nanDeck, and Andrea Nini has been amazingly responsive at fixing bugs quickly, and at pushing out new features frequently. But open source projects (if done right) build more of the user-developer community that I'm looking for.

Regarding being complicated. Personally, I made Squib to match the way I think. Doing rapid prototyping on card games is both complicated tedious no matter which way you slice it. Squib helps with the tedious part. Ruby provides so much to take complex tasks and condense them to readable code - I wanted to leverage that for a very specific task.

Yes, I know some people are scared away by the fact that it's programming. Or the fact that it's Ruby with some native dependencies. But (and this I know from my day job as a software engineering professor) Ruby is among the easiest programming languages to learn. Already, I've seen some folks over at BoardGameGeek enthusiastically pick up Ruby and learn it just for Squib (http://www.boardgamegeek.com/article/19640981). That's awesome and already more than I had hoped for.

crobi2• 11 years ago

Your project is certainly interesting, the comments regarding ease of use were just meant as a hint for how you could attract even more users.

Consider a hypothetical web application (no setup) where you write the same Ruby code and get a live preview (no need to explain windows users what a command line is) - this would take lots of work and money, but would probably be more popular.

Look also from the perspective of a person who is looking for a card design tool, is not emotionally attached to your project, and does not prefer Ruby over other languages. For these people, you compete against solutions like Tikz or Processing or some Python script, which are also capable of defining the content and layout of the cards separately. That's why I thought it might be a good idea to mention some amazing advantage of your tool in its short description.

If you want to create a community around your project, how about opening a gallery with examples, like the one the Tikz project has (http://www.texample.net/tikz/examples/all/)?

mrblues• 11 years ago

Anyone interested in this project might find this interesting.

http://paperize.io/beta

yellowapple• 11 years ago

I'd probably prefer something allowing everything to be defined from the Ruby side (other than the images themselves, of course, or at least other than the raster ones), similar to how Prawn works.

Pretty neat regardless.

andrey-p• 11 years ago

Relevant thing that was posted on HN last year: http://www.vassalengine.org/

I haven't had a chance to try it out but it looks great. Apparently it allows you to build board game mockups, and then play them locally or online. Useful for prototyping gameplay without having to print stuff, or alternatively you can also try games out before buying them.

nicolewhite• 11 years ago

I never had any plans to learn Ruby, but I'm going to now.

Squib: A Ruby DSL for prototyping card and board games

Related Stories