Giter Club home page Giter Club logo

customplatforms's Introduction

Installation

Easy Method

Manual Method

  • Ensure your game is patched with BSIPA (ModAssistant does this for you)
  • Place the CustomPlatforms.dll in your Beat Saber\Plugins directory

After a relaunch, your Beat Saber folder should look like this:

| Beat Saber
  | Plugins
    | CustomPlatforms.dll             <-- 
  | CustomPlatforms		      <--
    | <.plat files>		      <--
  | IPA
  | Beat Saber.exe
  | (other files and folders)

Controls

Visit the Platforms Menu page ingame to change your platform for different gamemodes

Adding More Platforms

Place platforms (.plat) files in the "BeatSaber\CustomPlatforms" folder. Your installed platforms will be available after a few seconds. A possible source for platforms is modelsaber.

Creating New Platforms

There's a comprehensive guide at https://bsmg.wiki/models/platforms-guide.html written by Emma. The following are the basic steps:

  1. Download the Unity project from releases, unzip it.

  2. Open the Unity project The project was created and tested in version 2019.4.18f1, other versions may not be supported.

  3. Create an empty GameObject and attach a "Custom Platform" component to it Fill out the fields for your name and the name of the platform. You can also toggle the visibility of default environment parts if you need to make room for your platform. Add an icon for your platform by importing an image, settings it to Sprite/UI in import settings, and dragging it into the icon field of your CustomPlatform

  4. Create your custom platform as a child of this root object You can use most of the built-in Unity components, custom shaders and materials, custom meshes, animators, etc.

  5. When you are finished, select the root object you attached the "Custom Platform" component to. In the inspector, click "Export". Navigate to your CustomPlatforms folder, and press save.

  6. Share your custom platform with other players by uploading the Platforms' .plat file

Building

  1. Clone the repository with git clone https://github.com/affederaffe/CustomPlatforms.git
  2. Go to the ./CustomPlatforms/Plugin/CustomFloorPlugin direcory and create a CustomFloorPlugin.csproj.user file, see the example below
  3. Open the solution file in the Plugins directory with e.g. VisualStudio or Jetbrains Rider and build the project

Example csproj.user File:

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <BeatSaberDir>Full\Path\To\Beat Saber</BeatSaberDir>
  </PropertyGroup>
</Project>

Hall of Fame (Credits for major rework contributions)

AkaRaiden - (The QA Department, Beta Tester, Tome of Wisdom)

  • Without him this would have taken so much more time than it did.

Rolo - (The Master Mind, Inventor CustomPlatforms)

  • Went out of her way to help me clean up after six people messed with this.

Panics - (Chief Investigator)

  • Helped me get an initial grasp on the damage.

Tiruialon - (Top-Cat)

  • Thank you for your contributions!

boulders2000 - (Bug Hunter)

  • Stopped counting how many bugreports he sent.

customplatforms's People

Contributors

affederaffe avatar rolopogo avatar kylemc1413 avatar brianhuang822 avatar assistant avatar luludotdev avatar panics11 avatar puredark avatar top-cat avatar zingabopp avatar brian91292 avatar ikeiwa avatar shadnix-was-taken avatar legoandmars 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.