\documentclass[10pt,a4paper]{article} % Packages \usepackage{fancyhdr} % For header and footer \usepackage{multicol} % Allows multicols in tables \usepackage{tabularx} % Intelligent column widths \usepackage{tabulary} % Used in header and footer \usepackage{hhline} % Border under tables \usepackage{graphicx} % For images \usepackage{xcolor} % For hex colours %\usepackage[utf8x]{inputenc} % For unicode character support \usepackage[T1]{fontenc} % Without this we get weird character replacements \usepackage{colortbl} % For coloured tables \usepackage{setspace} % For line height \usepackage{lastpage} % Needed for total page number \usepackage{seqsplit} % Splits long words. %\usepackage{opensans} % Can't make this work so far. Shame. Would be lovely. \usepackage[normalem]{ulem} % For underlining links % Most of the following are not required for the majority % of cheat sheets but are needed for some symbol support. \usepackage{amsmath} % Symbols \usepackage{MnSymbol} % Symbols \usepackage{wasysym} % Symbols %\usepackage[english,german,french,spanish,italian]{babel} % Languages % Document Info \author{Ozzypig (Ozzypig)} \pdfinfo{ /Title (roblox-gamepad-input.pdf) /Creator (Cheatography) /Author (Ozzypig (Ozzypig)) /Subject (Roblox: Gamepad Input Cheat Sheet) } % Lengths and widths \addtolength{\textwidth}{6cm} \addtolength{\textheight}{-1cm} \addtolength{\hoffset}{-3cm} \addtolength{\voffset}{-2cm} \setlength{\tabcolsep}{0.2cm} % Space between columns \setlength{\headsep}{-12pt} % Reduce space between header and content \setlength{\headheight}{85pt} % If less, LaTeX automatically increases it \renewcommand{\footrulewidth}{0pt} % Remove footer line \renewcommand{\headrulewidth}{0pt} % Remove header line \renewcommand{\seqinsert}{\ifmmode\allowbreak\else\-\fi} % Hyphens in seqsplit % This two commands together give roughly % the right line height in the tables \renewcommand{\arraystretch}{1.3} \onehalfspacing % Commands \newcommand{\SetRowColor}[1]{\noalign{\gdef\RowColorName{#1}}\rowcolor{\RowColorName}} % Shortcut for row colour \newcommand{\mymulticolumn}[3]{\multicolumn{#1}{>{\columncolor{\RowColorName}}#2}{#3}} % For coloured multi-cols \newcolumntype{x}[1]{>{\raggedright}p{#1}} % New column types for ragged-right paragraph columns \newcommand{\tn}{\tabularnewline} % Required as custom column type in use % Font and Colours \definecolor{HeadBackground}{HTML}{333333} \definecolor{FootBackground}{HTML}{666666} \definecolor{TextColor}{HTML}{333333} \definecolor{DarkBackground}{HTML}{DE302A} \definecolor{LightBackground}{HTML}{FCF2F1} \renewcommand{\familydefault}{\sfdefault} \color{TextColor} % Header and Footer \pagestyle{fancy} \fancyhead{} % Set header to blank \fancyfoot{} % Set footer to blank \fancyhead[L]{ \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{C} \SetRowColor{DarkBackground} \vspace{-7pt} {\parbox{\dimexpr\textwidth-2\fboxsep\relax}{\noindent \hspace*{-6pt}\includegraphics[width=5.8cm]{/web/www.cheatography.com/public/images/cheatography_logo.pdf}} } \end{tabulary} \columnbreak \begin{tabulary}{11cm}{L} \vspace{-2pt}\large{\bf{\textcolor{DarkBackground}{\textrm{Roblox: Gamepad Input Cheat Sheet}}}} \\ \normalsize{by \textcolor{DarkBackground}{Ozzypig (Ozzypig)} via \textcolor{DarkBackground}{\uline{cheatography.com/25526/cs/6778/}}} \end{tabulary} \end{multicols}} \fancyfoot[L]{ \footnotesize \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{LL} \SetRowColor{FootBackground} \mymulticolumn{2}{p{5.377cm}}{\bf\textcolor{white}{Cheatographer}} \\ \vspace{-2pt}Ozzypig (Ozzypig) \\ \uline{cheatography.com/ozzypig} \\ \uline{\seqsplit{ozzypig}.com} \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Cheat Sheet}} \\ \vspace{-2pt}Published 28th January, 2016.\\ Updated 24th January, 2017.\\ Page {\thepage} of \pageref{LastPage}. \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Sponsor}} \\ \SetRowColor{white} \vspace{-5pt} %\includegraphics[width=48px,height=48px]{dave.jpeg} Measure your website readability!\\ www.readability-score.com \end{tabulary} \end{multicols}} \begin{document} \raggedright \raggedcolumns % Set font size to small. Switch to any value % from this page to resize cheat sheet text: % www.emerson.emory.edu/services/latex/latex_169.html \footnotesize % Small font. \begin{multicols*}{2} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{ContextActionService basics}} \tn \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{Used for binding to inputs gracefully. If an input is bound to one action and another action is to use the {\bf{same}} button, the \{\{link="http://wiki.roblox.com/index.php?title=API:Class/ContextActionService/BindAction"\}\}BindAction\{\{/link\}\} and \{\{link="http://wiki.roblox.com/index.php?title=API:Class/ContextActionService/UnbindAction"\}\}UnbindAction\{\{/link\}\} functions will handle the collision properly. Example: {\bf{(A)}} could make the player jump OR open a door but only when close enough.% Row Count 10 (+ 10) } \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{Each input type bound to a function using BindAction works like a \{\{link="https://en.wikipedia.org/wiki/Stack\_\%28abstract\_data\_type\%29"\}\}stack\{\{/link\}\}: whichever function was the {\bf{most recent}} to be bound will be called when that input type is activated by the player.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{ContextActionService binding}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{noshy\}\}`:BindAction(name, func, touchButton, inputTypes...)`} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Calls `func` with `name`, InputState, and InputObject when `inputTypes` are used.} \tn % Row Count 4 (+ 4) % Row 1 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{noshy\}\}`:UnbindAction(name)`} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Unbinds a function from action `name`.} \tn % Row Count 6 (+ 2) % Row 2 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{noshy\}\}Input types for `:BindAction()`:} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}\{\{link="http://wiki.roblox.com/index.php?title=API:Enum/UserInputType"\}\}UserInputType\{\{/link\}\}, \{\{link="http://wiki.roblox.com/index.php?title=API:Enum/KeyCode"\}\}KeyCode\{\{/link\}\}, and/or \{\{link="http://wiki.roblox.com/index.php?title=API:Enum/PlayerActions"\}\}PlayerActions\{\{/link\}\}} \tn % Row Count 13 (+ 7) \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{As soon as a player can use an input (like A/B, triggers, or thumbstick), use `:BindAction(...)`. This will override the given input types current actions with the new one. When the player can no longer use the input for the action, use `:UnbindAction(name)`.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{ContextActionService example}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{noshy\}\} \newline {\bf{local}} cas = \{\{link="http://wiki.roblox.com/index.php?title=API:Class/ContextActionService"\}\}game:GetService("ContextActionService")\{\{/link\}\} \newline {\bf{function}} handleAction(actionName, \{\{link="http://wiki.roblox.com/index.php?title=API:Enum/UserInputState"\}\}inputState\{\{/link\}\}, \{\{link="http://wiki.roblox.com/index.php?title=API:Class/InputObject"\}\}inputObject\{\{/link\}\}) \newline ~~~{\bf{if}} actionName == "Swing sword" {\bf{and}} inputState == \{\{link="http://wiki.roblox.com/index.php?title=API:Enum/UserInputState"\}\}Enum.UserInputState.Begin\{\{/link\}\} {\bf{then}} \newline ~~~~~~print("Swinging sword") \newline ~~~{\bf{end}} \newline {\bf{end}} \newline \newline -{}- {\emph{When the sword is equipped:}} \newline cas:\{\{link="http://wiki.roblox.com/index.php?title=API:Class/ContextActionService/BindAction"\}\}BindAction\{\{/link\}\}("Swing sword", handleAction, {\bf{false}}, Enum.KeyCode.ButtonA) \newline -{}- {\emph{When the sword is unequipped:}} \newline cas:\{\{link="http://wiki.roblox.com/index.php?title=API:Class/ContextActionService/UnbindAction"\}\}UnbindAction\{\{/link\}\}("Swing sword")} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{When the given input type is activated/changed, the function passed to :BindAction(...) is called with the action name, the \{\{link="http://wiki.roblox.com/index.php?title=API:Enum/UserInputState"\}\}input state\{\{/link\}\} ({\bf{Begin}}, {\bf{Change}}, {\bf{End}} or {\bf{Cancel}}) and the \{\{link="http://wiki.roblox.com/index.php?title=API:Class/InputObject"\}\}InputObject\{\{/link\}\}. It's good practice to have just one action-handling function per script.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Wiki References}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Guides and Tutorials}}} \tn % Row Count 1 (+ 1) % Row 1 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=Gamepad\_input"\}\}Gamepad input\{\{/link\}\}} \tn % Row Count 3 (+ 2) % Row 2 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Game Services}}} \tn % Row Count 4 (+ 1) % Row 3 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=API:Class/ContextActionService"\}\}ContextActionService\{\{/link\}\}} \tn % Row Count 7 (+ 3) % Row 4 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=API:Class/UserInputService"\}\}UserInputService\{\{/link\}\}} \tn % Row Count 10 (+ 3) % Row 5 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{{\bf{Enum Types}}} \tn % Row Count 11 (+ 1) % Row 6 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=API:Enum/KeyCode"\}\}KeyCode\{\{/link\}\}} \tn % Row Count 13 (+ 2) % Row 7 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=API:Enum/UserInputType"\}\}UserInputType\{\{/link\}\}} \tn % Row Count 15 (+ 2) % Row 8 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=API:Enum/UserInputState"\}\}UserInputState\{\{/link\}\}} \tn % Row Count 17 (+ 2) % Row 9 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{link="http://wiki.roblox.com/index.php?title=API:Enum/PlayerActions"\}\}PlayerActions\{\{/link\}\}} \tn % Row Count 19 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Gamepad KeyCodes and UserInputTypes}} \tn \SetRowColor{LightBackground} \mymulticolumn{1}{p{8.4cm}}{\vspace{1px}\centerline{\includegraphics[width=5.1cm]{/web/www.cheatography.com/public/uploads/ozzypig_1453951757_KeyCodeLayout.png}}} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{Buttons use the UserInputStates Began/End. Triggers and thumbsticks use Change.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{UserInputService querying}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{fa-list\}\} Property ({\bf{boolean}}): \{\{noshy\}\}`GamepadEnabled`} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Returns {\bf{true}} if at least one gamepad is connected.} \tn % Row Count 4 (+ 4) % Row 1 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{\{\{fa-bolt\}\} Event: \{\{noshy\}\}`GamepadConnected`} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Fired when a gamepad is available.} \tn % Row Count 6 (+ 2) % Row 2 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{\{\{fa-bolt\}\} \seqsplit{Event:`GamepadDisconnected`}} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Fired when a gamepad is no longer available.} \tn % Row Count 8 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{\{\{fa-key\}\} Avoid using \seqsplit{`UserInputService.InputBegan`} for actions involving button presses!}} Use \seqsplit{`ContextActionService:BindAction(}...)` because this "overrides" existing actions using the given input types, and properly returns control to existing actions when yours are unbound.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Tips and Good Practices}} \tn % Row 0 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{A Button}} - Enum.KeyCode.ButtonA} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Bound to {\bf{jump}} by default. Should be used as {\bf{accept}} button for prompts.} \tn % Row Count 3 (+ 3) % Row 1 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{{\bf{B Button}} - Enum.KeyCode.ButtonB} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Should be used as {\bf{back}} or {\bf{cancel}} button for menus/prompts.} \tn % Row Count 6 (+ 3) % Row 2 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Right Trigger}} - Enum.KeyCode.ButtonR2} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Use for {\bf{primary}} character actions.} \tn % Row Count 8 (+ 2) % Row 3 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{{\bf{Left Trigger}} - Enum.KeyCode.ButtonL2} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Use for {\bf{secondary}} character actions.} \tn % Row Count 10 (+ 2) % Row 4 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Right Thumbstick}} - Enum.KeyCode.Thumbstick1} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Use for {\bf{camera}} movement.} \tn % Row Count 12 (+ 2) % Row 5 \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{{\bf{Left Thumbstick}} - Enum.KeyCode.Thumbstick2} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Use for {\bf{character}} movement.} \tn % Row Count 14 (+ 2) % Row 6 \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{{\bf{Right/Left Bumpers}} - \seqsplit{Enum.KeyCode.ButtonR1/ButtonL1}} \tn \mymulticolumn{1}{x{8.4cm}}{\hspace*{6 px}\rule{2px}{6px}\hspace*{6 px}Bound to {\bf{switch tools}} by default.} \tn % Row Count 17 (+ 3) \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{A good way to know what kinds of control schemes work is by playing other gamepad/controller enabled games.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} % That's all folks \end{multicols*} \end{document}