Code Monkey home page Code Monkey logo

mike-force's Introduction

README

IMPORTANT LICENSING INFORMATION

We're still finalising the license under which this code can be modified and redistributed. Until the new license is published, you can modify this work under the original license within this repository, further to the conditions stated here: https://community.sogpf.com/d/198-modifying-mike-force.

IMPORTANT BUILD INFORMATION

We're in the process of updating our build tools for Mike Force. They're in their final review phase, but we didn't want to prematurely push out buggy build tools. For now, the old tools should still work on Windows - see setup_dev_environment.py and build.py.

Issue Reporting

Report issues using the "Issues" section above. Please be sure to follow the template, and include as much detail as possible to help us figure out the best solution!

Downloading

Mike Force is hosted on the Steam Workshop. It's strongly advised to use Steam Workshop to manage the gamemode, and regularly check for updates, in case you're missing out on fixes or features!

Running

The gamemode is a self-contained mission file. Simply download the mission from Steam Workshop into your server's mpmissions folder, and select it from the in-game mission list.

Installation Instructions for BN Composition Devs / BN Scripts Devs

Prerequisites

You will need to install Python via the Microsoft Store. Open the windows start menu, search for Microsoft Store and open it. Then search for Python, any version 3 of Python will work. Install it.

You will need to download the code for both BN versions of Mike-Force and the Paradigm library.

For compositions devs, open each of the above links in an internet browser, then click on the Code dropdown (top right of each page) and select download as Zip. Extract the Zip files out into a suitable location on your computer, e.g. a new BN-MIKE-FORCE folder in your Documents folder.

You should now have two folders in your BN-MIKE-FORCE folder, namely Mike-Force and Paradigm.

For mission scripting devs, you should be do the above using git clone.

Setting up the missions

  1. In the BN-MIKE-FORCE\Mike-Force folder, copy the user_paths_example.py and save it as a new file named user_paths.py in the same folder.
  2. Open the file up with Notepad or similar.
  3. Delete out the text between the double quotes for both PARADIGM_PATH and MISSIONS_PATH i.e. r"everything between the quotes here"
  4. In Windows File Explorer, open up the BN-MIKE-FORCE\Paradigm folder. Double click in the address bar and copy the full location of the folder (Ctrl + C).
  5. Paste (Ctrl + V) this between the quotes on the same line as PARADIGM_PATH. It should look like this
PARADIGM_PATH = r"C:\Users\dijksterhuis\BN-MIKE-FORCE\Paradigm`
  1. In Windows File Explorer, open up your default Arma profile's directory. Double click in the address bar and copy the full location of the folder (Ctrl + C).
  2. Paste (Ctrl + V) this between the quotes on the same line as MISSIONS_PATH. Make sure it ends with \MP_Missions. It should look like this
MISSIONS_PATH = r"C:\Users\dijksterhuis\Documents\Arma 3\MPMissions`
  1. Save the user_paths.py file.
  2. Bring up the Windows start menu and search for Command Prompt. Right click on it and Run as Administrator.
  3. In Windows File Explorer, open up the BN-MIKE-FORCE\Mike-Force folder. Double click in the address bar and copy the full location of the folder (Ctrl + C).
  4. Back in the Command Prompt, type cd then press the spacebar then use Ctrl + V to paste in the Mike Force folder location. Press Enter.
  5. You should see some text saying different folders have been created and if nothing went wrong it should be asking you to press any key to exit.
  6. Press any key on your keyboard and close the COmmand Prompt.
  7. Start Arma3.
  8. Switch to your default game profile (or the profile where your linked MPMissions folder is under)
  9. Go to Multiplayer > Host Server > Click on Host Server (bottom right)
  10. You should see the multiplayer missions menu screen. Select a Map (Altis, CamLaoNam, KheSan or Bra).
  11. The Mike Force (v1.00.0+) should be highlighted in green. You can now enter the 3D editor or play as a non whitelisted unit (bottom right of the screen).

Whitelisted Units

When playing the BN mike force mission locally you will get errors popping up on your screen regarding the whitelist and curator players. This happens because you do not have a copy of the whitelisting database running locally and is perfectly normal. However, it does mean you cannot test anything regarding whitelisted units.

installation for development

Clone repo to local location of your choice and then symlink the vn_mf.cam_lao_nam folder into your Arma 3 missions folder.

Something like this:

C:\Users\USERNAME\Documents\Arma 3\missions

Windows symlinks are handled with the mklink command.

mklink /j "C:\Users\USERNAME\Documents\Arma 3\missions\vn_mf.cam_lao_nam" SGD_mikeforce\HAM\vn_mf.cam_lao_nam

note Use the standard windows commandline for this, bash on windows makes a mess of the paths.

The SGD_Paradigm folder is also required to by symlinked in to be the vn_mf.cam_lao_nam\paradigm folder.

mklink /j "C:\Users\USERNAME\Documents\Arma 3\missions\vn_mf.cam_lao_nam\paradigm" SGD_paradigm

generated doc file

Started a simple documentation generator : https://github.com/ryantownshend/sqf_tools

The file mikeforce_api.html is a super crude parse of the header comments from within the project.

This can be fleshed out as we go, but it does provide a single place to view all the function file headers.

mike-force's People

Contributors

alablm avatar cerebral-314 avatar dijksterhuis avatar hamlock-maneuverr avatar snipagus avatar spoffy avatar wescottj98 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.