Kit de Armas

Para ajudar na criação de experiências competitivas baseadas em combate, várias armas aprovadas estão disponíveis para uso em qualquer experiência. O sistema central conta com armas baseadas em projéteis com uma câmera sobre o ombro, e definir a velocidade do projétil alta o suficiente pode simular armas de raycasting, como pistolas laser.

Para usar uma arma aprovada em sua experiência:

1. Selecione uma arma abaixo, navegando até o link da biblioteca de ativos.

1. Na página do item da arma, clique no botão verde Obter e confirme a transação.

2. No Studio, abra a Caixa de Ferramentas.

3. Selecione a seção Inventário da sua caixa de ferramentas.

4. Localize a arma e clique nela para adicioná-la ao local. Ao ser solicitado se deseja colocar a ferramenta no pacote inicial, clique em Sim se quiser que os jogadores comecem com a arma na mochila, ou clique em Não para simplesmente colocar a arma no mundo 3D como um item de coleta.

5. Se esta for a primeira vez que está trazendo uma arma aprovada, mova a pasta WeaponsSystem para o ServerScriptService para servir como a pasta do sistema unificada para todas as armas aprovadas na experiência.

   

Estrutura da pasta do sistema

A pasta WeaponsSystem é uma pasta unificada que contém ativos, configurações e scripts que alimentam todas as armas aprovadas na experiência. Se localizada no ServerScriptService, ela substitui quaisquer pastas equivalentes WeaponsSystem que possam residir dentro de armas individuais.

A pasta WeaponsSystem contém as seguintes instâncias:

• Ativos (Folder)

  • Animações (Folder) – Armazenamento para animações usadas nos sistemas de armas.
  • Efeitos (Folder) - Cartuchos (Folder) – Armazenamento para todos os ativos de cartuchos de balas. - Marcas de Acerto (Folder) – Armazenamento para todos os efeitos de marca de acerto. - Disparos (Folder) – Armazenamento para todos os efeitos de disparo.
  • WeaponsSystemGui (ScreenGui) – Configurações para a GUI do Sistema de Armas.
• Configuração (Folder) – Valores de configuração para o sistema de armas.

  • SlowZoomWalkEnabled (BoolValue) – Configuração para controle de corrida.
  • SprintEnabled (BoolValue) – Configuração para controle de corrida.
• Bibliotecas (Folder) – Armazena todos os outros ModuleScripts usados no sistema de armas.
• TiposdeArmas (Folder) – Especifica todos os tipos de armas.
• ServerWeaponsScript (Script)
• Versão (IntValue)
• ClientWeaponScript (LocalScript)
• NetworkingCallbacks (ModuleScript)
• WeaponData (RemoteEvent)
• WeaponsSystem (ModuleScript)

Dentro da pasta WeaponsSystem, diferentes aspectos são controlados pelos seguintes ModuleScripts:

Estrutura da arma

Armas aprovadas são Tools e são nomeadas como aparecerão na mochila do jogador. Cada arma é estruturada com uma hierarquia semelhante.

Tipo de Arma

O WeaponType StringValue corresponde com o ModuleScript para a arma na pasta WeaponsSystem/WeaponTypes. Os dois valores base são BulletWeapon e BowWeapon.

Modelo da Arma

Cada arma contém um Model composto por uma ou mais BaseParts para formar a arma física. Um desses deve ser definido como a PrimaryPart do modelo.

O modelo também inclui os seguintes descendentes importantes que podem ser parentados a uma das BaseParts do modelo:

• TipAttachment – Attachment cuja posição na BasePart pai determina onde os projéteis saem.
• HandleAttachment – Attachment cuja posição na BasePart pai determina onde o Handle está soldado.
• Fired

  optional

  – Sound que toca quando a arma é disparada.
• Reload

  optional

  – Sound que toca quando a arma é recarregada.
• Descendentes adicionais para quaisquer opções especializadas.

Cabo da Arma

A parte Handle determina onde um personagem jogador segura a arma. Este deve ser um Part, deve ser nomeado Handle, e deve ser um filho direto da arma (ferramenta).

Pasta de Configuração

A pasta Configuration contém tipos de "valor" específicos para o comportamento da arma. Além dos valores padrão, você pode adicionar itens de configuração adicionais para opções especializadas quando aplicável.

A seguir estão as configurações básicas e seus valores padrão:

Opções especializadas

Você pode adicionar/modificar as seguintes opções para qualquer arma. Essas personalizações requerem modificar o Model da arma, a Configuration da arma, ou ambos. Algumas configurações dependem de outras, como Partículas de Bocal que requerem os filhos necessários para Efeitos e Sons de Projetil/Acerto.

Animações e sons do bolt

O bolt de uma arma é a parte que se move para frente e para trás cada vez que é disparada.

• Descendentes do Modelo da Arma

• Filhos da pasta Configuração da arma

Ejeção de cartuchos

As armas podem incluir cartuchos de bala físicos que ejetam ao disparar e caem no chão.

• Descendentes do Modelo da Arma

• Filhos da pasta Configuração da arma

• Filho do BasePart do cartucho em Assets/Effects/Casings da pasta do sistema

Efeitos e sons de projétil/acerto

Você pode configurar projetéis físicos para qualquer arma, junto com Sons, Feixes, e Emissores de Partículas para efeitos de acerto e outros efeitos especiais.

• Filhos da pasta Configuração da arma

Descendentes de ShotEffect

Descendentes do ShotEffect especificado na seção anterior

Partículas de bocal

Esta opção emite partículas do especificado ParticleEmitter no TipAttachment da arma quando é disparada.

Descendentes da configuração:

• ShotEffect (StringValue) — Nome de um efeito de disparo armazenado em WeaponsSystem/Assets/Effects/Shots.
• NumMuzzleParticles (IntValue) (opcional) — Número de partículas de bocal que serão emitidas; o padrão é 50.

Para o efeito de disparo especificado, adicione um ativo ParticleEmitter dentro de WeaponsSystem/Assets/Effects/Shots nomeado MuzzleParticles.

Flashes de bocal

Esta opção cria um efeito de flash Beam quando a arma é disparada.

Descendentes do modelo:

• MuzzleFlash0 (Attachment) — Usado para especificar um lado do flash de bocal. A posição não importa.
• MuzzleFlash1 (Attachment) — Usado para especificar o lado oposto do flash de bocal. A posição não importa.
• MuzzleFlash (Beam) — Certifique-se de definir Attachment0 para MuzzleFlash0 e Attachment1 para MuzzleFlash1.

Descendentes da configuração:

• MuzzleFlashTime (NumberValue) (opcional) — Duração que o flash de bocal será exibido; o padrão é 0.03.
• MuzzleFlashRotation0 (NumberValue) (opcional) — Rotação mínima do flash de bocal; o padrão é -math.pi.
• MuzzleFlashRotation1 (NumberValue) (opcional) — Rotação máxima do flash de bocal; o padrão é math.pi.
• MuzzleFlashSize0 (NumberValue) (opcional) — Tamanho mínimo do flash de bocal; o padrão é 1.
• MuzzleFlashSize1 (NumberValue) (opcional) — Tamanho máximo do flash de bocal; o padrão é 1.

Trilhas de partículas

Esta opção cria uma trilha de comprimento variável da arma até o ponto de impacto do projétil.

Descendentes da configuração:

• TrailLength (NumberValue) (opcional) — Comprimento da trilha atrás do projétil; o padrão é nil, o que significa que o comprimento da trilha será calculado usando TrailLengthFactor.
• TrailLengthFactor (NumberValue) (opcional) — O comprimento da trilha será definido para este valor multiplicado pela distância que o projétil viajou no último quadro; o padrão é 1. Observe que isso será substituído se você incluir TrailLength.
• ShowEntireTrailUntilHit (BoolValue) (opcional) — Defina como true para renderizar a trilha da ponta da arma até onde quer que o projétil esteja; isso substituirá tanto TrailLength quanto TrailLengthFactor e a trilha só desaparecerá uma vez que o projétil atinja algo. Defina como false para usar uma das duas opções acima para calcular o comprimento da trilha. O padrão é false.

Marcas de acerto

Esta adição visual aparece na superfície onde os projéteis atingem e é útil para flechas, buracos de bala, marcas de queimado, etc.

Descendentes da configuração:

• HitMarkEffect (StringValue) (opcional) — Nome do efeito de marca de acerto armazenado em WeaponsSystem/Assets/Effects/HitMarks; o padrão é BuracoDeBala.
• AlignHitMarkToNormal (BoolValue) (opcional) — Defina como true se a marca de acerto deve sempre se alinhar plana contra a superfície como um buraco de bala, ou false se a marca de acerto deve aparecer presa na superfície da direção de onde o projétil veio (como uma flecha). O padrão é true.

Você pode adicionar o seguinte ativo opcional dentro de WeaponsSystem/Assets/Effects/HitMarks:

• Glow (Decal) (opcional) — Aparece na superfície atingida totalmente opaca, depois rapidamente fica mais transparente, como um efeito de brilho na superfície que desaparece rapidamente. Útil para coisas como mostrar uma marca vermelha brilhante onde explosivos atingem.
• BuracoDeBala (Decal) (opcional) — Aparece na superfície atingida totalmente opaca e, após 4 segundos, desaparece para transparente por 1 segundo.
• ImpactBillboard (BillboardGui) (opcional) — Exibe na superfície atingida, sempre de frente para a câmera.

  • Impact (ImageLabel) (opcional) — Filho direto de ImpactBillboard; começa totalmente opaco, cresce para o tamanho total do ImpactBillboard em 0.1 segundos, depois encolhe para metade do seu tamanho e desaparece para totalmente transparente em 0.1 segundos.
• Qualquer Part/MeshPart/SpecialMesh que você deseja aparecer como um projétil físico (opcional). Por exemplo, incluir uma MeshPart de flecha e definir AlignHitMarkToNormal indicado acima para false fará com que a flecha saia da superfície na direção de onde você a disparou.

Projetéis explosivos

Os projéteis podem incluir um objeto de Explosão para causar dano a personagens jogadores em uma área ao redor do ponto de impacto.

Descendentes da configuração:

• ExplodeOnImpact (BoolValue) (opcional) — Defina como true se você quiser que balas/projetéis da arma explodam ao impactar, false caso contrário. O padrão é false.
• BlastRadius (NumberValue) (opcional) — Raio de explosão; o padrão é 8.
• BlastPressure (NumberValue) (opcional) — Pressão de explosão; o padrão é 10000.
• BlastDamage (NumberValue) (opcional) — Dano causado às coisas no centro da explosão. Observe que a explosão causa menos dano quanto mais longe os objetos atingidos estão do centro da explosão. O padrão é 100.

Arma de carga

Uma arma de carga, como o Railgun, precisa ser carregada entre disparos antes que possa ser disparada novamente.

Descendentes do modelo:

• Charging (Sound) (opcional) — Toca enquanto a arma está sendo carregada.
• Discharging (Sound) (opcional) — Toca enquanto a arma está descarregando, por exemplo, se você carrega a arma apenas parcialmente e solta o botão de disparo.
• ChargeComplete (Sound) (opcional) — Toca quando a arma alcançou carga total.
• DischargeComplete (Sound) (opcional) — Toca quando a arma foi totalmente descarregada.
• ChargeGlow (BasePart) (opcional) — Este objeto ficará menos transparente à medida que a arma carga, de modo que ficará totalmente opaco a 100% de carga.
• ChargeCompleteParticles (ParticleEmitter) (opcional) — Emite quando a arma termina de carregar. Este emissor pode ser um filho de qualquer BasePart do modelo ou um filho de um Attachment dentro do BasePart.
• DischargeCompleteParticles (ParticleEmitter) (opcional) — Emite quando a arma foi completamente descarregada. Este emissor pode ser um filho de qualquer BasePart do modelo ou um filho de um Attachment dentro do BasePart.
• ChargingParticles (ParticleEmitter) (opcional) — Emite enquanto a arma está sendo carregada. Você pode incluir vários emissores desse nome e cada um emitirá enquanto estiver carregando. Este emissor pode ser um filho de qualquer BasePart do modelo ou um filho de um Attachment dentro do BasePart.

Descendentes da configuração:

• ChargeRate (NumberValue) — Taxa na qual a arma carregará. Este valor deve ser especificado para indicar que a arma usa carregamento.
• DischargeRate (NumberValue) (opcional) — Taxa na qual a arma descarregará; o padrão é 0, o que significa que a arma não descarregará.
• ChargePassively (BoolValue) (opcional) — Defina como true se quiser que a arma carregue passivamente para que dispare instantaneamente quando você clicar, ou false se quiser clicar/tocar para carregar a arma e disparar assim que a carga total for alcançada. O padrão é false.
• ChargingParticlesRatePerCharge (IntValue) (opcional) — Número de partículas que serão emitidas de todos os emissores de ChargingParticles multiplicado pela carga atual da arma. O padrão é 20, o que significa que se a carga da arma estiver a 10%, cada emissor de ChargingParticles emitirá 2 partículas (20×0.1), e se a carga da arma estiver a 90%, cada emissor emitirá 18 partículas (20×0.9).
• FireDischarge (NumberValue) (opcional) — Quantidade de carga que a arma perderá após disparar um disparo totalmente carregado; o padrão é 1.
• NumChargeCompleteParticles (IntValue) (opcional) — Número de partículas que o emissor ChargeCompleteParticles emitirá uma vez que a arma estiver totalmente carregada. O padrão é 25.
• NumDischargeCompleteParticles (IntValue) (opcional) — Número de partículas que o emissor DischargeCompleteParticles emitirá quando a arma estiver totalmente descarregada. O padrão é 25.

Arma de arco

Uma arma de arco, como a Bestica, pode incluir uma construção de corda e braços realista, bem como uma flecha visual nockada na corda.

Além de adicionar descendentes ao modelo, você precisa aplicar o seguinte:

• Transforme a arma em uma arma de carga. Por exemplo, adicione a ChargeRate necessária dentro da Configuration da arma que especifica a velocidade com que a corda é puxada. Além disso, considere adicionar descendentes opcionais ao Model da arma, como um som de Charging para a corda/braços sendo puxados para trás.
• Defina o WeaponType como BowWeapon conforme indicado na Estrutura da Arma.

Descendentes do modelo:

• LeftString (Beam) (opcional) — A metade visual esquerda da corda.
• RightString (Beam) (opcional) — A metade visual direita da corda.
• Arrow (BasePart) (opcional) — A flecha que aparece quando o arco está totalmente puxado. Observe que isso é apenas para aparência visual no arco (a flecha realmente disparada será um ShotEffect conforme descrito em Efeitos e Sons de Projetil/Acerto).
• String1 (Attachment) (opcional) — O ponto central da corda.
• StringLoose (Attachment) (opcional) — Ponto onde String1 deve estar quando o arco está em repouso.
• StringTight (Attachment) (opcional) — Ponto onde String1 deve estar quando o arco está totalmente puxado.
• Arms (Part) (opcional) — Uma parte que serve apenas como um indicador interno de que os braços do arco serão animados. Isso pode conter os seguintes filhos diretos:
• LeftString0 (Attachment) (opcional) — Ponto onde o lado esquerdo da corda está preso ao arco.
• RightString0 (Attachment) (opcional) — Ponto onde o lado direito da corda está preso ao arco.
• LeftLoose (Attachment) (opcional) — Ponto onde LeftString0 deve estar quando o arco está em repouso.
• RightLoose (Attachment) (opcional) — Ponto onde RightString0 deve estar quando o arco está em repouso.
• LeftTight (Attachment) (opcional) — Ponto onde LeftString0 deve estar quando o arco está totalmente puxado.
• RightTight (Attachment) (opcional) — Ponto onde RightString0 deve estar quando o arco está totalmente puxado.
• [SpecialMesh] (SpecialMesh) (opcional) — A parte do arco que realmente se dobra quando o arco é puxado. Observe que você deve especificar os seguintes quatro objetos Vector3Value para que isso anime.
• LooseOffset (Vector3Value) (opcional) — Deslocamento do SpecialMesh quando o arco está em repouso.
• TightOffset (Vector3Value) (opcional) — Deslocamento do SpecialMesh quando o arco está totalmente puxado.
• LooseScale (Vector3Value) (opcional) — Escala do SpecialMesh quando o arco está em repouso.
• TightScale (Vector3Value) (opcional) — Escala do SpecialMesh quando o arco está totalmente puxado.

GUI do sistema de armas

O sistema central das armas interage com este sistema para atualizar a GUI com base em elementos como a dispersão da arma, indicadores para quando você é atingido ou acerta outros, etc.

A WeaponsSystemGui é um objeto ScreenGui em WeaponsSystem/Assets que é parentado ao PlayerGui quando a experiência começa. O WeaponSystemGui possui 4 descendentes:

• ScalingElements - Uma Folder de elementos na tela.
• LargeTouchscreen - Uma Frame para botões em grandes telas sensíveis ao toque.
• Scope - Uma Frame para ampliar com armas que usam um escopo.
• SmallTouchscreen - Uma Frame para botões em telas sensíveis ao toque pequenas.

Elementos de Escala

ScalingElements é uma Folder parentada sob WeaponsSystemGui com os seguintes descendentes:

LargeTouchscreen

LargeTouchscreen é uma Frame contendo botões que são exibidos em grandes telas sensíveis ao toque. LargeTouchscreen tem os seguintes descendentes:

• AimButton (ImageButton)
• FireButton (ImageButton)

Scope

Scope é uma Frame que contém ScopeImage (ImageLabel) que aparece ao ampliar uma arma com HasScope habilitado (veja Estrutura da Arma).

Scope tem os seguintes descendentes:

SmallTouchscreen

SmallTouchScreen é uma Frame contendo botões que são exibidos em pequenas telas sensíveis ao toque. SmallTouchscreen tem os seguintes descendentes:

• AimButton (ImageButton)
• FireButton (ImageButton)

Criar um indicador direcional

Indicadores direcionais são usados para mostrar a direção de algo ao redor da mira do jogador. Por exemplo, se alguém te atirar, um semi-círculo vermelho pode aparecer ao redor da sua mira na direção de onde o tiro veio. Outros exemplos incluem indicadores para mostrar a direção de passos, tiros indiretos, ou até mesmo objetos ambientais como baús.

Para criar um novo indicador, adicione um novo Frame de Indicador em WeaponsSystemGui/ScalingElements/DirectionalIndicators com a seguinte estrutura:

Uma vez criado, você pode ativar um indicador via o seguinte comando dentro de WeaponsSystem/Libraries/WeaponsGui onde indicatorName é o nome da string do indicador a ser ativado e worldPos é a posição mundial onde o indicador direcional deve apontar:

self.DirectionalIndicatorGuiManager:ActivateDirectionalIndicator(indicatorName, worldPos)

Configuração do indicador

Os DirectionalIndicators podem ser ainda mais modificados ajustando o objeto Configuration parentado sob o [Indicator]. Todas essas configurações têm um valor padrão, portanto, não há necessidade de configurar itens quando não estiver modificando uma configuração.

As seguintes configurações podem ser definidas:

Mostrar painel de dano

O painel de dano é usado para mostrar números pequenos acima da cabeça de um personagem quando são danificados. Esses aparecerão apenas para o jogador que causou dano a outro personagem jogador, não para jogadores espectadores.

Os painéis de dano são gerenciados em WeaponsSystem/Libraries/DamageBillboardHandler e podem ser ativados de qualquer código do lado do cliente da seguinte forma, onde damage é a quantidade de dano feito e adornmentPart é a parte na qual adornar o painel, como a cabeça da vítima:

DamageBillboardHandler:ShowDamageBillboard(damage, adornmentPart)

Câmera sobre o ombro

A câmera sobre o ombro é uma câmera em terceira pessoa que olha sobre o ombro direito do personagem jogador. Para personalizar a câmera sobre o ombro, modifique as variáveis sob o comentário -- Parâmetros de configuração (constantes) na função ShoulderCamera.new() de WeaponsSystem/Libraries/ShoulderCamera. Você pode modificar coisas como campo de visão, deslocamento em relação ao personagem, velocidade de caminhada enquanto correndo ou ampliando, etc.

Controle de corrida e zoom

Por padrão, o sistema de armas adiciona a capacidade de "correr", para que os jogadores possam correr segurando a tecla Shift, pressionando totalmente para cima no thumbstick dinâmico (móvel), ou pressionando totalmente para cima no joystick esquerdo (gamepad). Se você deseja desabilitar a corrida, defina o valor de SprintEnabled dentro de WeaponsSystem/Configuration para false.

O sistema também reduz a velocidade do jogador enquanto eles estão mirando/ampliando, mas você pode desabilitar esse comportamento definindo o valor de SlowZoomWalkEnabled para false.