Giter Club home page Giter Club logo

cudlr's Introduction

CUDLR

CUDLR (Console for Unity Debugging and Logging Remotely) is a remote developer console for Unity. Instead of struggling to enter console commands on a mobile devices or having to constantly export debugging logs from a device, CUDLR lets you use your development machine to enter debug commands and see their output or any log messages or stack traces.

To do this, CUDLR starts a webserver on the target device to host static files and exposes a HTTP API for executing commands which can interface with your project.

We wrote CUDLR to use in Proletariat's upcoming game, World Zombination. For more info on why we wrote it and other tools we've released, check out our blog.

Features

  • Supports iOS, Android, PC/Mac Standalone, and the Unity Editor
  • Capture Unity log messages and stack traces
  • Console runs in any browser
  • Copy/paste from/to the console
  • Tab completion
  • Command history
  • Standard text-entry shortcuts (ctrl-a, ctrl-e, etc)
  • Uses standard HTML/CSS for layout

How do I use CUDLR?

  • Download the unitypackage from github or the Unity Asset Store and import it in to your project.
  • Create an empty GameObject in the scene and add the CUDLR->Server component.
  • Set the port on the component (default value is 55055).
  • Add the CUDLR.Command attribute to your code.
  • Run the game and connect to http://localhost:55055 with your browser.

An example CUDLR Server GameObject prefab is located in Assets/CUDLR/Examples. Add the GameObject to the scene, run the game, and connect to the console with your browser.

An example of adding commands is available here.

Adding Additional Commands

Add a ConsoleCommand attribute to any static method. When the Command String is entered into the console the Delegate will be called passing in any additional arguments used in the console.

[CUDLR.Command(<Command String>, <Description>, <Optional: flag to run on main thread>)]

The CUDLR.Command Callback Delegate returns void and either takes void or a string[] of arguments.

public delegate void Callback(string[] args);
public delegate void CallbackSimple();

Delegate functions can output data to the console by calling the CUDLR Console Log function or using Unity's built-in logging.

CUDLR.Console.Log( <Log String> );

Adding Additional Routes

Add a CUDLR Route attribute to any static method. When the route regex is matched, the Delegate will be called passing in the http context and optionally the regex result.

[CUDLR.Route(<Route Pattern>, <Optional: Method Pattern>)]

License

CUDLR is distributed under The MIT License (MIT), see LICENSE.

cudlr's People

Contributors

jkurlancheek avatar joemukai avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.