Git Product home page Git Product logo

kero's Introduction

GoDoc Go report card codecov CircleCI

Kero

Kero is a Source Engine game client implementation written in Go.

Current Features

  • BSP rendering with visdata support
  • Skybox rendering
  • Lightmap support (incomplete, BSP geometry only)
  • Staticprop rendering
  • Prop entity rendering (incomplete, models with bones unsupported)
  • Bullet physics for brush:physics entity collisions
Build Kero, run it by pointing it to a Source Engine game installation, and it should just work!

Building

Prerequisites

This project is tested against Go 1.14+, although will probably build on Go 1.12 or later. CGo is required for Imgui and Bullet. To compile with the physics module, Bullet is required;

  • On Mac OS it can be installed with brew install bullet.
  • See Bullet documentation for other platforms

Build

To build the project on Windows, Mac OS or Linux, all you need to do is run (assuming you have Go 1.12 or later installed) in the directory samples/demo: go build .

The demo targets Counterstrike: Source entities. To target a different game, you will need to update samples/demo/gameDef.go.

Running

First, you will need to have a source engine game installed, unless you are loading a map that has all its content bspzipped.

  • Run the built executable with this flag: -game="<GameDir>/<ContentDir>", where <GameDir> is the root directory of the game, and <ContentDir> is the sub-folder where the game content is located (e.g. cstrike, hl2, csgo etc). For example, a default Counterstrike: Source installation would be specified like this: -game="C:\Program Files (x86)\Steam\Steamapps\common\Counterstrike Source\cstrike"

What's the end goal?

  • An accurate-as-possible renderer compared to the original source engine
  • A physics environment for client-side simulation (Bullet will perform as "close enough")
  • Sound/audio playback
  • Expose an interface for controlling/passing game state in/out (e.g. demo files, netcode, etc)
  • Expose an interface for game specific implementations to be built on top
  • Headless mode. Be able to run this without a renderer or audio output
  • Interface for querying game data at runtime (e.g. LoS calculations between entities)
  • As little reliance on CGo as possible
  • 0 reliance on any valve code or libraries

Contributing

  1. Fork it (https://github.com/galaco/kero/fork)
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request

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.