Zukai: Difference between revisions

213 bytes added ,  14 July 2015
m
various tiny improvements
(adding Firewall/signing tip for hosts, moving host tips to new section)
m (various tiny improvements)
Line 22: Line 22:
'''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 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 a Japanese word connected to the ancient art of puppetry and puppet theater (''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'' (操り).
 
{{TOClimit}}


==Download==
==Download==
Line 36: Line 38:


==Playing==
==Playing==
[[Image:Zukai-Main Menu.jpg|thumb|350px|right|Look for the Zukai icon in the bottom-left before proceeding.]]
[[Image:Zukai-Main Menu.jpg|thumb|350px|left|Look for the Zukai icon in the bottom-left before proceeding.]]
 
[[Image:Zukai-MP Menu.jpg|thumb|350px|right]]
[[Image:Zukai-MP Menu.jpg|thumb|350px|right]]
# Decide what level you are going to play. Obtain the IP address of the player that will be hosting. If you get tired of dealing with IP addresses, players can sign up for a [http://www.noip.com/ No-IP] domain and provide that URL to players instead, e.g. iritscen.ddns.net.
<div style="overflow:hidden">
# Launch Oni. Look for the Zukai icon on the Main Menu (pictured, right) to make sure that the plugin is active.
#Decide what level you are going to play. Obtain the IP address of the player that will be hosting. If you get tired of dealing with IP addresses, players can sign up for a [http://www.noip.com/ No-IP] domain and provide that URL to players instead, e.g. joe-onifan.ddns.net.
# Choose "Load Game" and load the level you are going to play (you can double-click the title or any save point, since scripting is disabled).
#Launch Oni. Look for the Zukai icon on the Main Menu (pictured, left) to make sure that the plugin is active.
# Press your mp_menu key to bring up the Multiplayer Menu (pictured, right).
#Choose "Load Game" and load the level you are going to play (you can double-click the title or any save point, since scripting is disabled).
# Just follow the menus. The option "Join Iritscen's game" will not work unless I have let you know that I am hosting a game. If you are joining a game, and the other player has registered a No-IP domain or has some other URL which leads to his computer, you can type this into the "Host IP address" field instead of an IP address. Also note that you can copy text from another window such as your chat client and paste it into the "address" field in the Multiplayer Menu.
#Press your mp_menu key to bring up the Multiplayer Menu (pictured, right).
# Because gameplay cannot be paused, you are not allowed to access the Main Menu while playing Zukai. To quit playing, bring up the Multiplayer Menu and choose "Exit game", or double-tap the Escape key (if the host quits, this will end the match for everyone).
#Just follow the menus. The option "Join Iritscen's game" will not work unless I have let you know that I am hosting a game. If you are joining a game, and the other player has registered a No-IP domain or has some other URL which leads to his computer, you can type this into the "Host IP address/URL" field instead of an IP address. Also note that you can copy text from another window such as your chat client and paste it into the address field in the Multiplayer Menu.
 
#Because multiplayer cannot be paused, you are not allowed to access the Main Menu while playing Zukai. To quit playing, bring up the Multiplayer Menu and choose "Exit game", or double-tap the Escape key (if the host quits, this will end the match for everyone).
</div>
===Hosting tips===
===Hosting tips===
*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 internal (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 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 copy of Oni to your Firewall exceptions (System Preferences > Security > Firewall > Firewall Options... > + button). Sometimes this will not work, in which case you need to open Terminal and use the command:
*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):
  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/
If you see the message ".../Oni.app: replacing existing signature", then it was successful. If it does not work, try the command several more times. It often doesn't seem to work on the first try.
:You will then have to enter your administrator password. If you see the message "[…]/Oni.app: replacing existing signature", then it was successful. If it does not work, try the command several more times; it often doesn't seem to work on the first try.


==Bindable actions==
==Bindable actions==
Line 78: Line 80:


;jitter_toggle, jitter_up, jitter_down
;jitter_toggle, jitter_up, jitter_down
:Simulated jitter (variations in latency) is automatically turned on when simulated latency is turned on, but you can use these actions to turn it off (to get flat simulated latency) or to alter the amount of jitter.
:Simulated jitter (variation in latency) is automatically turned on when simulated latency is turned on, but you can use these actions to turn it off (to get flat simulated latency) or to alter the amount of jitter.


;pkt_rate_up, pkt_rate_down
;pkt_rate_up, pkt_rate_down
Line 123: Line 125:
|yes/no
|yes/no
|no
|no
|If there is an issue with the automatic log reporting, turning this on will dump messages from the upload process into the system log (Console.app).
|If there is an issue with the automatic log upload, turning this on will dump messages from the upload process into the system log (Console.app).
|}
|}


[[Category:Modding projects]]
[[Category:Modding projects]]