Jump to content

Zukai: Difference between revisions

5 bytes removed ,  11 October 2016
m
Mac OS X -> macOS
m (→‎Useful websites and programs: let's not recommend OBS over QT Player when it's so much harder to use)
m (Mac OS X -> macOS)
Line 20: Line 20:
|}
|}


'''Zukai''' is the most recent attempt at [[multiplayer]] for [[Oni]]. Zukai is in an alpha-like stage of development for Mac OS X until it reaches v0.1, at which point it will be ported to Windows, and development will continue on both platforms. It currently comes in the form of an OS X bundle called '''Daodan.plugin''' and an Oni [[AE:Plugins|level plugin]] called '''level0_Zukai''' with supplemental resources.
'''Zukai''' is the most recent attempt at [[multiplayer]] for [[Oni]]. Zukai is in an alpha-like stage of development for macOS until it reaches v0.1, at which point it will be ported to Windows, and development will continue on both platforms. It currently comes in the form of a bundle called '''Daodan.plugin''' and an Oni [[AE:Plugins|level plugin]] called '''level0_Zukai''' with supplemental resources.


''Zukai'' is a Japanese word connected to the ancient art of puppetry and puppet theater (''[[wikipedia:bunraku|bunraku]]'').  Its usage in this project is based on the expression ''Ningyō Zukai'' ("Puppet Master") in [[Ghost in the Shell]], though translations of the word ''zukai'' alone range from "messenger" to "operator" to "familiar spirit" to "trainer". The icon for the project is based on the ''kanji'' for another word for puppetry, ''ayatsuri'' (操り).
''Zukai'' is a Japanese word connected to the ancient art of puppetry and puppet theater (''[[wikipedia:bunraku|bunraku]]'').  Its usage in this project is based on the expression ''Ningyō Zukai'' ("Puppet Master") in [[Ghost in the Shell]], though translations of the word ''zukai'' alone range from "messenger" to "operator" to "familiar spirit" to "trainer". The icon for the project is based on the ''kanji'' for another word for puppetry, ''ayatsuri'' (操り).
Line 51: Line 51:
*If you want to be able to host games, and not just join other people's games, make sure that you have forwarded port 2680 (UDP) to your computer's LAN (private) IP address in your router's settings. See this [http://portforward.com/english/routers/port_forwarding/routerindex.htm port forwarding guide] for help.
*If you want to be able to host games, and not just join other people's games, make sure that you have forwarded port 2680 (UDP) to your computer's LAN (private) IP address in your router's settings. See this [http://portforward.com/english/routers/port_forwarding/routerindex.htm port forwarding guide] for help.
*Until there is metaserver support (i.e., a matchmaking lobby), you will need to arrange matches with other players using a third-party program like an instant messenger or an IRC client (our community IRC channel is #Oni at euIRC.net).
*Until there is metaserver support (i.e., a matchmaking lobby), you will need to arrange matches with other players using a third-party program like an instant messenger or an IRC client (our community IRC channel is #Oni at euIRC.net).
*Some hosts are plagued by the OS X dialog that says "Do you want the application 'Oni' to accept incoming network connections?" each time someone tries to join their game. To turn this off, you should add this Oni application to your Firewall exceptions (System Preferences > Security & Privacy > Firewall > Firewall Options... > '+' button). Sometimes this will not work, in which case you need to open Terminal and use this command, remembering to supply the correct path to your Oni application (your administrator password will be requested):
*Some hosts are plagued by the macOS dialog that says "Do you want the application 'Oni' to accept incoming network connections?" each time someone tries to join their game. To turn this off, you should add this Oni application to your Firewall exceptions (System Preferences > Security & Privacy > Firewall > Firewall Options... > '+' button). Sometimes this will not work, in which case you need to open Terminal and use this command, remembering to supply the correct path to your Oni application (your administrator password will be requested):
  sudo codesign --force --deep --verbose --continue --file-list - --sign - /path/to/Oni.app/
  sudo codesign --force --deep --verbose --continue --file-list - --sign - /path/to/Oni.app/
:This performs ad-hoc code-signing, which takes the place of an official developer certificate. If successful, you will see output like this:
:This performs ad-hoc code-signing, which takes the place of an official developer certificate. If successful, you will see output like this:
Line 58: Line 58:
  /Applications/Oni/Oni.app/Contents/_CodeSignature/CodeResources
  /Applications/Oni/Oni.app/Contents/_CodeSignature/CodeResources


If it does not work, try the command several more times; it often doesn't seem to work on the first try. However, even if the signing is successful, you <u>still have to tell OS X that the app is allowed to accept incoming connections</u>, which means that you will get the dialog again the next time that you host. Once you click that "Allow" button one more time, OS X should remember that this "signed" copy of Oni can accept connections.
If it does not work, try the command several more times; it often doesn't seem to work on the first try. However, even if the signing is successful, you <u>still have to tell macOS that the app is allowed to accept incoming connections</u>, which means that you will get the dialog again the next time that you host. Once you click that "Allow" button one more time, macOS should remember that this "signed" copy of Oni can accept connections.


==Useful websites and programs==
==Useful websites and programs==
Line 64: Line 64:
*[http://www.noip.com/ No-IP.com] can be used to set up a domain for someone who wants to host frequently, allowing the easier exchange of host addresses with joiners than giving out the host's IP address.
*[http://www.noip.com/ No-IP.com] can be used to set up a domain for someone who wants to host frequently, allowing the easier exchange of host addresses with joiners than giving out the host's IP address.
*If the performance of an Internet game seems poor, you can check your general connection quality with [http://www.speedtest.net Speedtest.net] and [http://www.pingtest.net/ Pingtest.net]. Usually, the bandwidth measurement that Speedtest.net will give you is unimportant, as Zukai does not use much bandwidth. Pingtest.net is more useful because it gives you a jitter measurement, and gameplay is more sensitive to jitter than to high latency.
*If the performance of an Internet game seems poor, you can check your general connection quality with [http://www.speedtest.net Speedtest.net] and [http://www.pingtest.net/ Pingtest.net]. Usually, the bandwidth measurement that Speedtest.net will give you is unimportant, as Zukai does not use much bandwidth. Pingtest.net is more useful because it gives you a jitter measurement, and gameplay is more sensitive to jitter than to high latency.
*Zukai measures the ping to other players and displays it when you press the mp_score button (see "Bindable actions" section), but if you want more rigorous measurement of the connection between yourself and another player, bring up Spotlight in OS X and start typing "Network Utility". When the Utility appears, open it and use the Ping tab to test the connection between you and them. The most important numbers in the final statistics, once pinging is done, are the packet loss, which should be 0-1%, the average ping ("round-trip avg", the third-to-last number), and jitter ("stddev", the last number), which should be less than 25% of the average ping.
*Zukai measures the ping to other players and displays it when you press the mp_score button (see "Bindable actions" section), but if you want more rigorous measurement of the connection between yourself and another player, bring up Spotlight in macOS and start typing "Network Utility". When the Utility appears, open it and use the Ping tab to test the connection between you and them. The most important numbers in the final statistics, once pinging is done, are the packet loss, which should be 0-1%, the average ping ("round-trip avg", the third-to-last number), and jitter ("stddev", the last number), which should be less than 25% of the average ping.
*To record video footage of a match, see [[Capturing game footage]]. The recommended free method is using either OBS Studio or QuickTime Player for video, and capturing the game audio with either Soundflower or iShowU Audio Capture. The recommended commercial programs are ScreenFlow and iShowU, which capture both audio and video.
*To record video footage of a match, see [[Capturing game footage]]. The recommended free method is using either OBS Studio or QuickTime Player for video, and capturing the game audio with either Soundflower or iShowU Audio Capture. The recommended commercial programs are ScreenFlow and iShowU, which capture both audio and video.